Distributed Systems Network (A) packaro 


x 
HP 32192A 
Multileaving Remote Job Entry 
(DSN/MRUJE) 
Reference Manual 


oe 
Ae pyldhiele om 








APR RR? 






big or Ee 
Ae 


HP 3000 Computer Systems 


DSN/MRJE Multileaving Remote 
Job Entry 


Reference Manual 


HEWLETT 


Y) PACKARD 


19420 HOMESTEAD ROAD, CUPERTINO, CA 95014 





" Part No. 32192-90001 Printed in U.S.A. 3/82 
U07 83 Updated 07/83 


NOTICE 
The information contained in this document is subject to change without notice. 


HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATER- 
IAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY 
AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors 
contained herein or for incidental or consequential damages in connection with the furnishing, perfor- 
mance or use of this material. 


Hewlett-Packard assumes no responsibility for the use or reliability of its software on equipment that is 
not furnished by Hewlett-Packard. 


This document contains proprietary information which is protected by copyright. All rights are reserved. 
No part of this document may be photocopied, reproduced or translated to another program language 
without the prior written consent of Hewlett-Packard Company. 


Copyright © 1982 by HEWLETT-PACKARD COMPANY 


ii 

















LIST OF EFFECTIVE PAGES 





The List of Effective Pages gives the date of the current edition and of any pages changed in updates to that edition. 
Within the manual, any page changed since the last edition is indicated by printing the date the changes were made 
on the bottom of the page. Changes are marked with a vertical bar in the margin. If an update is incorporated when an 
edition is reprinted, these bars are removed but the dates remain. 


Changed Pages 


2 490 244% 
vii - xii... 
4-3 - W-&... 
A-5 - A-6.. 

B-3 - B-& ... 
D-7 - D-12 . 

E-1 - E-3 ... 


eeesee#ee??8e¢e@¢ 


Fifth Edition .... 


«@e¢eee#8%e8 86 6 


July 
ieee: OULY 
itv wanes SULY 
July 
vee seca: OULY 


oe e702 @?86 0@ 8 0 © July 


.. duly 


oe0eee8@ 8 @ 


Sneuies ... Mar 1982 
Date Changed Pages 
TOG3: <V8. weaeng Seas July 
1983 1-9 ...ccccccocvceeee July 
1983 5-3 - 5-4 ........ eee July 
1983 A-9 - A-10 .......... July 
1983 C-9 - C-12 ....... ~+. July 
1983 D-19 - D-20 ......... July 
1983 G-15 - G-20 ......... July 
iii 


Date 
1983 
1983 
1983 
1983 
1983 
1983 
1983 


July 1983 


PRINTING HISTORY 





Mirst EQiQON: 04 odo Wo aU bea Set eee we JON 1918s ces Shy ates en eae 32192A.00.00 
Update NO, A iccie 32.8 Seca waeare eis ose eee oss MAY 1078 6m 48 6a cs Be sed drdce er 32192A.00.01 
Update No. 1 Incorporated. .................0.. NOV TOTS iced tah ea alah age ae 32192A.00.01 
Second Edition ........ 0... 0c cee eee eee ee eee | i hb a 32192A.01.00 


This edition presents discussion of JES3 and ASP, updated error messages, textual improvements. 
Lhird Baition: oc $0.8 aS ae SS ea SS aR SUP TIS. 55 -e ocala ate ew eee eek 32192A.01.01 
The text has been substantially revised to improve clarity and to reflect changes in MRJE/3000. 


Changes include the replacement of the =MRJE command with the distributed console command, 
:MRJECONTROL, the introduction of host console message logging, new command interpreter error messages, 
and the capability for MRJE/3000 operation of the INP. 


Fourth Edition... 0.0... ce ee ee ee ee AUG AISLE 3 Coa hd eae Ses 32192A.01.03 


In Edition 4, the manual has been changed to reflect the renaming of MRJE/3000 to DSN/MRJE. The manual 
has also been modified to document the use of the HP2680A Laser Printer for printing MRJE output. Edition 
4 includes an expanded discussion of the management of unsolicited output, documentation of the new 
MRJECONTROL command for checking software version, fix and update levels (: MRJECONTROL CHECK), 
enhanced error message definitions and descriptions of recovery procedures, and an MFJE installation pro- 
cedure, located in Appendix B. 


BAGH MGiHOM 4: 5. sce, ches: 6 aes eek wae TOS bee aK BOD LOG 2 -5.5:5,6.5-ehwse ere eta tec 32192A4.02.00 


In Edition 5, the manual has been changed to describe these new features: 


The DSN/MRJE monitor had been a system process. It now operates as a user process, in a session or a 
job. 


Solicited job output may be routed to unsolicited output devices, as specified in the configuration file. 
Infiles can be submitted in transparent mode. 

Automatic dial up connection can take place between an HP 3000 and a host computer. 

DSN/MRJE messages are not contained in a message catalog file. 

A HELP command facility has been added. 

A performance message facility to measure host job data received has been added. 


Update Number 1 .......... Jul 1983 ..........+. 32912A.02.00 


The fifth edition of the manual has been updated to incorpor- 
ate operation of a communication line at 56000 bits-pver- 
second (56Kb). A Bell Digital Data Service ( DDS) 56Kb 
leased line is required, as well as an HP 30020B INP with a 
30221D (V.35) cable. A Bell 500B Data Service Unit (DSU), or 
a GTE L500A DSU (as was used in HP’s testing), is required. 


A SETDUMP command has been added to the MRJESTRh file 
examples in various parts of the manual. 


These modem specifications have been added: 
Bell Dataphone II 2024A 
Bell Dataphone II 2048A 


Bell Dataphone II 2096A 
Bell 500B Data Service Unit 


iv 











This publication is the reference manual for Multileaving Remote 
Job Entry (DSN/MRJE). DSN/MRJE is a subsystem of the HP 3000 
computer system, and it provides for the submission of multiple 
batch job streams to remotely-located host computers operating 
HASP, JES2, JES3, or ASP Job Entry Subsystems. 


This manual addresses three types of readers: 
DSN/MRJE Users: 


Persons who access the DSN/MRJE subsystem, in either batch 
or session mode, to submit jobs for processing on a host 
system. 


The DSN/MRJE Manager: 


The person who plans DSN/MRJE use and enters DSN/MRJE Mana- 
ger commands to build DSN/MRJE configuration files and to 
monitor the activity of the subsystem. 


DSN/MRJE Console Operators: 


The persons who operates the HP 3000 master console and 1/0 
devices and any other person authorized to control the com- 
munication link(s) between the HP 3000 and remote host(s) 
from his or her terminal. 


It is assumed that readers of this manual are already familiar 
with the pertinent operating characteristics of their host sys- 
tems. 


SECTION I of this manual is an introduction to the capabilities, 
structure and operation of the DSN/MRJE product. 


SECTION II explains how to prepare job streams for entry to the 
host via DSN/MRJE and to prepare for output from the host. 


SECTION III lists the DSN/MRJE commands available to the DSN/MRJE 
User and describes their function and syntax. User access’ to 
host console commands is also described. 


SECTION IV discusses the management of DSN/MRJE, including the 
construction and maintenance of management files and DSN/MRJE 
Manager commands. 


SECTION V explains the DSN/MRJE commands used to open, monitor, 
and close the HP 3000-host communications link at the HP 3000 
end. 


PREFACE (Continued) 


SECTION VI is a listing of error conditions and suggested 
recovery procedures. 





The APPENDICES provide information on DSN/MRJE management file 
configuration, configuration of the HP 3000 and the host for com- 
munication with DSN/MRJE, and modem options and strappings. 


The reader may wish to refer to the following manuals for pubeTe 
mental information: 


@ MPE IV System Manager /System Supervisor Reference Manual (HP 
30000-90014) 


@ Console Operator's Guide: Series II, III, 30, 33 and 44 (HP -' 
32002-90004) 


@e HP 30055A Synchronous Single-Line Controller (SSLC). Installa- 
tion and Service Manual (HP 30055-90001) 


@ HP 30010A Intelligent Network Processor (INP) Installation and 
Service Manual (HP 30010-90001) 





@ HP 30020A/B Intelligent Network Processor (INP) Installation 
and Service Manual (HP 30020-90001) 


@ Communications Handbook (HP 30000-90105) 

@ MPE Utilities Reference Manual (HP 30000-90044) 

@ MPE Commands Reference Manual (HP 30000-90009) 

@ Using Files (HP 30000-90102) “ 
@ IBM manuals relevant to the host operating system (for 


example, OS/MFT, OS/MVT, OS/VS2 (MVS and SVS)) and Job Entry 
Subsystem (HASP-II, JES2, JES3, OR ASP). 
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DSN/MRJE AND REFERENCE MANUAL CONVENTIONS 





COMMAND 


parameters 


delimiters 


C ] 


All commands used in this manual are shown in 
upper case and are typed in their entirety. 


Command names may be abbreviated to the mini- 
mum number of characters required to uniquely 
identify them and may be entered in upper or 
lower case. 


Variable parameters which are replaced by 
user-supplied values are shown in lower case 
characters. 


These parameters may be abbreviated to the 
minimum number of characters needed to unique- 
ly identify them and may be entered in upper 
or lower case. | 


Example: H{LOST] B[ETA] 


Commas are optional except within "joblist" or 
"itemlist". A slash (/) signifies a range of 
values beginning with the number to the left 
of the slash and ending with the number to the 
right. 


Examples: #DISPLAY JOB 25 
Valid #DISPLAY, JOB, 25 

#ALTER 5,6 

Invalid #ALTER 5 6 


An element inside brackets is optional. 
Several elements stacked vertically inside 
brackets means one element may be selected, 
although none need be. 


Example: [A ] 
C BJ 


User may select A or B or neither. 


An ellipsis indicates that the previous ele- 
ment may be repeated, or that elements have 
been omitted. 
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{ } 


joblist or 
itemlist 


blanks 


Example 1 


Several elements’) stacked vertically within 
braces means the user must select one of the 
elements. 


Example: {A } 
{ B} 
{c} 


User must select A or Bor C. 


Some commands permit a list and/or range of 
parameters to be specified: 


job# , JOob# / job# 
jobname , jobname , Jobname 


item# [,item#][/item#] ... 


In these commands the parameters may be re- 
peated and job# and jobname intermixed. 


Examples: ALTER 25 
ALTER 2/7,25,1,12/15 


CANCEL JOB 6 
CANCEL JOB 3/5, JOBXYZ,8 (Cancels 
jobs 3, 4, 5, 8, and JOBXYZ.) 


Commands may be preceded by blanks; they need 
not start in column 1 of a card image. At 
least one blank (or a comma) is required to 
separate command parameters. 


Examples: #DISPLAY C,9 
Valid #DISPLAY C, 9 
# DISPLAY C,9 
Invalid #DISPLAYC, 9 
User/Manager input to the terminal is  under- 


lined to distinguish it from subsystem 
prompts. 
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return 


card 


actual file 


Console Operator 
(DSN/MRJE ) 


current host 


default host 


host 


host ID 


host number 


Type the carriage return key. 


The word "card" is interchangeable with "card 
image." Each represents an 80-character record 
of stored information. 


A file resident on disc. 


The person who operates the HP3000 system 
console and I/O devices and any other person 
authorized to control the communication 
link(s) between the HP3000 and remote host(s) 
from his or her terminal. 


The host to which all jobs and host’ console 
commands will be sent, until another host is 
selected by means of the HOST command. Unless 
the DSN/MRJE User issues the HOST command, 
the "current host" is always the same as the 
"default host". 


The host machine which is selected, by 
default, for DSN/MRJE job and host console 
command processing when the :MRJE command is 
issued. All jobs and commands will be sent to 
this host until another host is specified (via 
the HOST command). The "default host" is also 
the host whose communication line will be 
affected when the Console Operator issues an 
:MRJECONTROL command without specifying a host 
ID. 


The mainframe machine on which jobs and host 
console commands’ submitted through DSN/MRJE 
are executed. It is not the HP 3000. Multi- 
ple hosts may be attached to a single HP 3000. 


An alphanumeric name by which a host is iden- 
tified. A user of DSN/MRJE uses a host's’ ID 
(or the first character of the ID) in the 
"hostid" parameter that is part of several 
DSN/MRJE commands. DSN/MRJE uses only the 
first character of the host ID (or no charac- 
ter at all, in the case of the default host) 
in its communication with DSN/MRJE Users and 
Managers. 


The number the host system assigns to a job at 


the time it receives that job. The user need 
not remember this number. 
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job number 


job name 


MRJE Manager 


MRJE User 


system file 


user 


The number DSN/MRJE assigns a job when the 
job is submitted by a User. The number should 
be noted so it can be used in future commands 
that reference the job. 


The User-assigned name by which a job is iden- 
tified. It need not be unique. The DSN/MRJE 
User uses job names on host JOB cards in job 
input files and in the “jobname" parameter 
that is part of several DSN/MRJE commands. 


The person who plans DSN/MRJE use and enters 
DSN/MRJE manager commands to build DSN/MRJE 
configuration files and to monitor the 
activity of the subsystem. 


A person who accesses the DSN/MRJE- subsysten, 
in either batch or session mode, ‘to submit 
jobs for processing on a host system. 


A system defined file designator indicating 
those files that MPE identifies for a job or 
session: SSTDIN, S$STDINX, SSTDLIST, SNULL, 
SOLDPASS, and SNEWPASS. 


Anyone, Manager, User, or Console Operator who 
uses DSN/MRJE. 


This character is the DSN/MRJE subsystem 
prompt for terminal input. It is displayed at 
a user's terminal whenever DSN/MRJE is ready 
to accept a command. 


xV 





















INTRODUCING DSN/MRJE 


The Distributed Systems Network/Multileaving Remote Job Entry 
(DSN/MRJE) subsystem of the HP 3000, runs under the control of 
the Multiprogramming Executive (MPE) operating system. DSN/MRJE 
gives multiple users of the HP 3000 access to any remotely- 
connected host computer system that is using the HASP-II (version 
3.1 or subsequent), JES2, JES3, or ASP Job Entry Subsystem. Jobs 
may be submitted from the HP 3000 via the standard input devices 
(magnetic discs, magnetic tapes, card readers, and terminals); 
and output from the host may be routed to any of the standard HP 
3000 output devices (printers, discs, tapes, card punches, and 
terminals). Jobs may be submitted during an interactive session 
with DSN/MRJE or by means of a batch (stream) job. 


In addition to accommodating multiple users, DSN/MRJE provides 
for an DSN/MRJE Manager who can interactively monitor and con- 
trol job activity. Host console commands can be entered by _ the 
Manager from any HP terminal. Users may also be given access to 
one or more host console commands by the Manager. 


DSN/MRJE can handle up to seven logical print streams, seven 
logical punch streams, seven logical card reader streams, and a 
command console input/output stream, all transmitted over the 
same communications line. 


DSN/MRJE can run on suitably-configured HP 3000's (Series II or 
later) which have at least one operational communications con- 
troller. Depending on the model of HP 3000, controllers may be 
Synchronous Single-line Line Controllers (SSLC's) and/or Intel- 
ligent Network Processors (INP's). 


Multiple hosts and multiple communications lines to the same host 
are supported by DSN/MRJE. Communications with the host(s) are 
governed by multileaving protocol and may take place over dial-up 
(switched) and leased lines. Modem speeds of up to 9600 bits per 
second are supported on appropriate communication lines. 


Figure 1-1 shows a generalized DSN/MRJE communications system. 


DSN/MRJE FEATURES 


The DSN/MRJE subsystem provides commands for DSN/MRJE Users’ to: 
@® Specify a particular host machine for job processing. 


@ Submit jobs for execution on a host system. 
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@ Specify job output disposition. 

@ Display the status of their jobs. 
@e Cancel their jobs. 

@ Exit DSN/MRJE. 


In addition, any user with the MPE System Supervisor (OP) capabi- 
lity can manage DSN/MRJE resources. The user MANAGER.SYS_ should 
have OP capability. A DSN/MRJE Manager can: 


@ Configure the files for DSN/MRJE operation, both required and 
optional. 


® Display job status for any job being handled by DSN/MRJE. 
@ Cancel any job being handled by DSN/MRJE. 
e Alter the current DSN/MRJE configuration file. 


@® Maintain the DSN/MRJE job log file. 


RUNNING DSN/MRJE 


Your group and account must have a MAXPRI=CS or higher in order 
to use DSN/MRJE. To execute DSN/MRJE, log onto the HP 3000 sys- 
tem with the standard HELLO or JOB and then issue the MRJE 
command. If the subsequent MRJE output (for example, listings 
produced by the DISPLAY command) is to be routed to a file as 
well as to S$SSTDLIST, precede the command with a file equation as 
shown. (If the file has not already been built, use the FILE 
command parameters ",NEW;SAVE".) 


sFILE LISTING=filename [,NEW;SAVE ] 
:MRJE 


After the product identification is printed by DSN/MRJE, all 
users can submit jobs to DSN/MRJE, check job status, and cancel 
jobs. In addition, the Manager can monitor DSN/MRJE activity and 
perform other supervisory tasks. The Manager might, for example, 
define a new host machine by building or altering a configuration 
file, cancel users’ jobs, or purge unwanted entries from the job 
log file. 
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PLANNING JOB INPUT AND OUTPUT 


A job submitted to the host via DSN/MRJE may use the host appli- 
cation programs, utilities, and languages that are available to 
other remote users of the same host. Jobs are prepared by enter- 
ing job control information, programs, and data into MPE files in 
card image format (as if they were being entered directly to the 
host on cards). DSN/MRJE builds job streams from the files and 
transmits the job streams to the host system(s). Users may 
create disc files that will receive job output. Preparation of 
input and output files is discussed further in Section II. 


Submitting Jobs 


Submission of jobs to the host is a two-step process. They must 
first be submitted to DSN/MRJE. DSN/MRJE then submits them to 
the host. If the communications link to the host is open, 
DSN/MRJE will transmit jobs as they are submitted (subject to 
MPE control). Otherwise, they will be spooled until communica- 
tions between the host and DSN/MRJE have been established. 
Spooling of job input will occur only if a pseudo reader has been 
spooled. 


The submission of jobs will be refused if the psuedo reader is 
not spooled and the host is offline or if the pseudo reader is 
busy. 


Jobs are submitted to DSN/MRJE in files. DSN/MRJE assigns a 
number to each job and displays these number(s) at the sub- 
mitter's terminal. The jobs may subsequently be referred to by 
this number. 


Transmitting Jobs and Receiving Output 


In order to transmit jobs to the host, the communications line 
between the HP 3000 and the host must be opened. This is done by 
issuing the distributed console command, :MRJECONTROL START, or 
its equivalent. (See Section V for further discussion of 
sMRJECONTROL commands. ) 


DSN/MRJE will then access the spooled input files (if any) that 
were created from input files specified in SUBMIT commands and 
transmit the jobs stored in the spooled files to the host system. 


The host system will execute the jobs and return output to the HP 
3000 system. The return of output depends on factors such as 
host system execution time and job turn-around time. 
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DSN/MRJE will receive the output, determine from DSN/MRJE job 
log and directory files where the output is to be sent (for exam- 
ple, to a disc file or to a line printer), and then route the 
output to the proper output device. 
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DSN/MRJE MANAGEMENT FILES 


For each host machine configured into DSN/MRJE by the Manager, 
logged on as MANAGER.SYS, DSN/MRJE creates a set of three files 
in PUB.SYS: 


@ The configuration file (MRJECONh). 

@® The job log file (MRJEJOBh). 

@ The directory file (MRJEDIRh). 

These files are accessed during DSN/MRJE execution. 


MRJECON, MRJEJOB, and MRJEDIR are the names DSN/MRJE assigns to 
the set of files created for the default host machine. In multi- 
ple host environments, DSN/MRJE appends the first character of 
the host identification, ‘h' above, to the ends of these names to 
create unique file names. The names can subsequently appear in 
messages to users. 


The message catalog file, MRJECAT, is installed as part of the 
DSN/MRJE product in the group and account PUB.SYS. This file 
contains most of the messages used by the subsystem. 


There are other files associated with DSN/MRJE. These may be 
created by the Manager, logged on as MANAGER.SYS, or by any user 
who can log on to the SYS account in the PUB group. These are 


@® The stream file (MRJESTRh).» 
@® The message file (MRJEMSGh). 


The stream file is always accessed when an MRJECONTROL START com- 
mand is issued. The other files may be accessed during execution 
of the subsystem. 


Configuration File 


This file contains host machine configuration information. 
Entries exist for the host SIGNON card image, the default 
input/output devices for DSN/MRJE, line connect/disconnect times 
and other information. The DSN/MRJE Manager can alter specific 
items in this file, or rebuild the entire file, if changes occur 
in the host or HP 3000 system. The format and contents of a con- 
figuration file are described in Appendix A. 
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Job Log File 


This file contains information about each job submitted to the 
host machine for which this file was created. The file includes 
the job number, the job name, the MPE logon ID of the User who 
submitted the job, the destination files specified for the job 
output (printer, punch, and/or special forms), the status of the 
job (if and when the job was transmitted or canceled), and, if 
the job was transmitted, the number assigned to it by the host. 
A job log file entry could look like this: 


JOB#=4 JOBNAME=MYJOB3 USER=PAT.DCA,M 
PRINT="LP" PUNCH="CLPUN" FORMS="BANKFORM" 
TRANSMITTED TO HOST TUE, MAY 23, 1980, 4:06 PM HOST#=2354 


Directory File 


This file is an index to entries in the job log file. It is used 
by DSN/MRJE to find entries more quickly and is not accessible 
to users of DSN/MRJE. 


The Message Catalog File 


This file contains most of the messages the DSN/MRJE subsystem 
displays for the system operator, the DSN/MRJE manager, and the 
subsystem user. The message catalog file is created when the 
subsystem is installed. It may be useful to modify the message 
catalog file in those environments where users do not’ speak 
English. 


If the message catalog is modified, remember to include 
any message parameters in the same sequence as was done 
in the original file. 


The Stream File 


The stream file is always used whenever an MRJECONTROL START com- 
mand is issued. It should be created MANAGER.SYS, but may be 
created by any user with access to the PUB group of the SYS 
account. Security for this file should be restricted to 
MANAGER.SYS by using the MPE command ALTSEC, as described in the 
"MPE Commands Reference Manual" (30000-90009). The structure of 
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this file is the same as for any stream file. The contents of 
the stream file, MRJESTRh, are such that an MPE session which 
runs the monitor MRJEMON will be executed. A sample stream file 
is included with the description of MRJECONTROL START in Section 
5. 


The Message File 


The message file is used to receive host console messages, ouput 
messages from the host system, and a performance measurement data 
record which contains information about output data received. 
The message file may be either an output system file, such as 
SSTDLIST, or an actual file. If the message file is an actual 
file, MRJEMSGh.PUB.SYS, then it should be created by MANAGER. SYS, 
and access to it should be limited to its creator. Use the 
ALTSEC command, as described in the "MPE Commands Reference 
Manual" (30000-90009). See Section 4. This file is optional. 
If it is absent all messages intended for it are lost. 
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WHAT YOU CAN DO WITH DSN/MRJE ON 
A HIGH SPEED COMMUNICATION LINE 


DSN/MRJE can communicate with a host system at 56000 bits-per- 
second (56Kb). When an HP2680 laser printer is connected to an 
HP3000, such as in an HP2685 Model 40 Print Station, you can have 
avery cost-effective remote print station for an IBM plug- 
compatible host system that operates in a bisynchronous (BSC) 
network. 


An HP3000 operating at 56Kb line speed must include 
® A Bell DDS communication line configured at 56Kb 
@ An HP30020B Intelligent Network Processor (INP) 
@ An HP30221D (30221-60010) INP cable with a V.35 hood 


e A Bell 500B Data Service Unit (DSU) modem or its equiv- 
alent, such as GTE L500A DSU as was used in testing. 


@ Multileaving buffers should be as large as possible to 
obtain performance benefits. 


When operating at a high line speed you should consult with host 


system operations. Also, configure two printer streams for 
better subsystem performance at this speed. 
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SECTION 


PLANNING DSN/MRJE JOBS 





When preparing jobs for submission to a host, the DSN/MRJE User 
must take into account certain host system characteristics (such 
as the type of Job Entry Subsystem, languages supported) and the 
HP 3000 resources configured for DSN/MRJE. Many host system 
characteristics are listed in the configuration file; for others 
the DSN/MRJE Manager or the host system manager must be consult- 
ed. The contents of the configuration file may be examined using 
the DSN/MRJE DISPLAY command. (See Section III for details on 
the use of the DISPLAY command. The format of the configuration 
file is described in Appendix A.) 





JOB INPUT 


Job input submitted to a host using a physical card reader nor- 
mally consists of individual jobs composed of HASP, JES2, JES3, 
or ASP job control (JCL) cards, executable programs (also on 
cards), and data cards. The job control information, programs 
and data are concatenated to form a job stream. 





Jobs submitted via DSN/MRJE must be constructed as they would be 
for direct submission to the host via a card reader. However, 
input through DSN/MRJE is in the form of "card-images" rather 
than physical cards. Each card image is a record that is 80 col- 
umns wide. The records are commonly combined into MPE files by 
the user; the files can then be submitted to DSN/MRJE for 
processing. 





DSN/MRJE concatenates the files into a single job stream, identi- 
fies the individual jobs within that stream, and transmits’ the 
jobs to the host one by one. (They may be interleaved with jobs 
from other job streams as they are transmitted.) In the simplest 
case, a job stream is created from a single file; in more compli- 
cated cases, the stream is built from several files. 


DSN/MRJE accepts input from up to three levels of card image 
files: 


e Infiles 


@e Level-one FD files 





@e Level-two FD files 
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Infiles are specifically named in a SUBMIT command, while FD 
files are referenced indirectly by means of a card-image pointer 
from an Infile or another FD file. Only two levels of indirect 
file reference are permitted. A level-two FD file may not point 
to another file. See Section 3 for a description of the SUBMIT 
command. 





Figure 2-1 illustrates the relationships among several card image 
files that have been merged into a single job stream. The names 
of the Infiles were indicated by the user when submitting the 
job. First-level FD files, RED and BLUE, were specified indi- 
rectly by means of records (card images) contained in Infile A. 
Two records within RED point to the two level-two files. 


When DSN/MRJE processes a SUBMIT command, it opens. each Infile 
named directly in the command, and each FD file as it is refer- 
enced. Those files specified by an actual file designator are 
opened with the MPE semi-exclusive and read-only file restric- 
tions. All others are opened with the MPE  read-only/exclusive 
restrictions. Each file remains open until all of its records 
have been processed, at which time it is immediately closed. 


Infiles 


Infiles may contain complete or partial jobs. Infiles may contain 
##FD cards that point to level-one or level-two FD cards. It is 
possible for an Infile to consist solely of ##FD cards. An Infile 
and its FD files (if any) must form complete jobs. An Infile may 
be transmitted in transparent mode; however, DSN/MRJE Manager 
(OP) capability is required to do this. Its purpose is to allow 
transmission of host system JOB cards as data. This means that 
such jobs will not be entered into the job log file of the sub- 
System. An infile may also be transmitted without translation. 
(See SUBMIT command Section III for further discussion. Also, 
see Appendix B for sample input files.) 


FD Files 
FD files are similar to Infiles in that they may contain the same 
kind of information and are constructed in the same. way. FD 


files may be transmitted transparently, as well as without 
translation. However, they are referenced directly by means of 
##FD cards contained within the Infiles. (See figure 2-1.) 


Files may not be nested to more than two levels. In other words, 
one file may reference another, which may itself reference 
another, but the third file may not reference any file. 
For example, file A in figure 2-1 contains an ##FD card pointing 
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to file RED; file RED has ##FD cards pointing to files WHITE and 
CLEAR. The second-level files, WHITE and CLEAR, do not reference 


any other files. 


FD files may reference Infiles, but restrictions on levels of 
nesting still apply. 
























Infiles A and X are submitted to DSN/MRJE in the SUBMIT 
command, Exemple:.SUBMIT A,X 


Card images will be transmitted to the host in this order: 
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| CARD X1 
CARD X3 
| CARD X4 


CARD X5 
CARD X6 


FD FILES 


LEVEL-ONE FD FILES LEVEL-TWO FD FILES 
RED WHITE 
























[CARD w2__ | 
[caro rs ||@ [CARD WS 





CARD R6 
##FD WHITE 


##FD CLEAR 


BLUE 
| CARD B2_ 
| CARDB3 | 
| CARD B4 
| CARD BS 
| CARD B86 
| = CARD BS 
























JOB STREAM 


Relationships Among Files in a Job Stream 
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##FD cards have the format: 


##FD filename [ (N[COTRANSLATE][,T[RANSPARENT]]) ] Ceomment] 
[ (TLRANSPARENT]([,NCOTRANSLATE]]) ] 


where 
##FD (File Definition) must occupy columns 1 through 4. 


NOTRANSLATE No translation requests that the FD file be 


transmitted without translation. Refer to the 
SUBMIT command for more information about 
translation. 


TRANSPARENT Transparent transmission requests that all JOB 
cards in the FD file be passed to the host as data. 
As a result, all the JOB cards will be ignored by 
DSN/MRJE. If the (T) parameter is included, the 
proper JCL must still be included so the host will 
also treat the JOB cards as data. Use the proper 
DD card. 


Examples: 


##FD FILEB(T) **Ignore JOB cards in FILEB** 


##FD C (N,T) **Do not translate C; ignore JOB cards** 


If a file is built that requests input from S$STDIN or SSTDINX, 
the optional comment field on the ##FD card should be used to 
identify the type of input that is expected. Then, when the job 
input stream is constructed, the comment will be printed at the 
user's terminal ahead of the standard DSN/MRJE message: ENTER 
INPUT ENDING WITH "“MRJEOD". For example, if the infile DATAI1 
contains the record 


##FD SSTDIN This input is for file DATAIL. 
the following will appear at the terminal: 


This input is for file DATA1. 
ENTER INPUT ENDING WITH "MRJEOD" 
> 
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INFILE A 


JOB STREAM 


CG) THIS CARD TRANSMITTED AS VALID CONTROL CARD 


THIS CARD TRANSMITTED AS PART OF JOB1 AND THUS 
HAS NO EFFECT ON JOB2. 





Figure 2-2. Host Priority Card to Job Stream Relationship 


Host System Job Control 


DSN/MRJE does not check a job stream for conformity to host job 
stream criteria before transmitting it. It does, however, scan 
all input files for /*SIGNOFF. If a /*SIGNOFF card appears any- 
where in the input files, a warning message is printed and the 
card is not transmitted to the host. 


If the TRANSPARENT parameter (T) is omitted from an Infile refer- 
ence, or from ##FD card image, DSN/MRJE will recognize all JOB 
cards contained in the referenced file as job delimiters, not 
data. 


PRIORITY cards will have no effect on the host when associated 
with the second or subsequent job in a job stream. Figure 2-2 
illustrates a situation in which two jobs are submitted to 


DSN/MRJE together. DSN/MRJE will merge Infile A with FD file 
RED. The first priority card will then have the desired effect 
on JOB1. The second priority card will be transmitted to the 


host as part of JOB1 and therefore will not influence JOB2. 
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When priorities are important, each job should be submitted to 
DSN/MRJE separately. 


INPUT FILE LIBRARIES 


The job streaming feature of DSN/MRJE allows users to construct 
jobs out of job control cards, programs, and data that already 
exist in disc files. This makes it possible to create libraries 
of job modules that can be assembled into a variety of different 
jobs. 


It is up to the DSN/MRJE User to ensure that Infiles and FD 
files submitted together constitute a valid job (or jobs) accord- 
ing to host system requirements. 


JOB OUTPUT 


Job output can be routed to a disc file or to any output device 
by designating the output files in the SUBMIT command. Pre- 
defined output routing may take place to files designated when- 
ever the DSN/MRJE monitor is started. All files can be formatted 
for print, punch, and special forms data. Record sizes should be 
specified as follows: 


@ REC=-132,,F,ASCII;CCTL--for print and special forms files. 


@ REC=-80,,F,ASCII--for punch files. 


(Specification of output files is explained further in Section 
III under the SUBMIT command. ) 


NOTE 


If a SUBMIT command names a disc output file, the file 
must be built with sufficient extents allocated. DSN/ 
MRJE does not allocate additional extents if the need 
for them arises, although it does notify the system 
Operator when the limits of a file have been reached. 


When DSN/MRJE receives job output from the host, the output file 
(or files) is opened with append-only access and the output is 
written to the file(s). 





> 
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Output sent to spooled output devices is owned by the user. and 
account of the submitter. 


Sometimes output is not sent to the destination specified by the 
user, but ends up going to a destination for unsolicited output 
instead. If this happens, check with the HP 3000 system operator 
or the MRJE Manager; MRJE apparently may not be able to recognize 
that the output was for your job. 


Carriage Control Translation 


The host normally prefixes a carriage control character to 
records that are for output to a printer with standard paper or 
special forms. Output for card punch does not have carriage con- 
trol information. DSN/MRJE translates host system carriage con- 
trol information as shown in Table 2-l. 


Table 2-1. Host System to HP 3000 Carriage Control Translation 


HOST SYSTEM CONTROL HP 3000 CONTROL CODE 
AND EXPLANATION 


Skip n spaces immediately (if necessary used 
(n < 3) to indicate immed- 
iate skip) 
(nn < 3) 


Skip immediately to channel n (if necessary used 
(n < 13) to indicate immed- 
iate skip) 
(channel 1), or 
(channel nn, where 
2<nn < 12) 


Skip n lines after printing (if necessary used 
(n < 3) | to indicate immed- 
iate skip) 
(nn < 3) 


Skip to channel n after printing (if necessary used 
(n < 13) to indicate immed- 
iate skip) 
(channel 1), or 
(channel nn, where 
2<nn < 12) 


All other host system control codes| Single space 
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Special Forms Processing 


The DSN/MRJE User can have job output printed on special forms 
by including the necessary host JCL Forms Control statements in 
the job stream. The output will then be routed to the disc file 
or I/O device that was specified when the job was submitted. 


Whenever special forms output destined for printers is received 
from the host system, the HP 3000 console operator is prompted to 
mount the required special form on the printer. After the form 
has been mounted, MPE can write the output file to the printer. 
This is true for both spooled and unspooled ("hot") printers. 
Use ‘hot' printers with caution, because data in transition may 
be lost. 


When output is printed on an HP 2680A Laser Printer using an 
Environment File, the console operator is NOT prompted to mount 
special forms. The specifications in the Environment File will 
automatically be used to print the forms and to format the out- 
put. See "Printing Output on an HP .2680A Laser Printer", below. 


DSN/MRJE only recognizes automatic special forms, that 
is, CLASS=A ona DD card (host JCL). It does not sup- 
port special forms of any other class nor does it  sup- 
port special forms for punch output. This is because 
CLASS=A is the only one which sends a console message to 
identify the form to be mounted. 


It is important to note that although several jobs may be sub- 
mitted within one SUBMIT command and each job may generate 
several sets of data for different special forms, all data sets 
are routed to the single forms file or print file which was de- 
fined explicitly or by default in the SUBMIT command. This is 
explained further in Section III. 


Printing Output on an HP 2680A Laser Printer 


Output from DSN/MRJE jobs can be printed on HP 2680A Laser 
Printers. Data output can be printed with the use of Environment 
Files, if the user so wishes. Another method for doing this is 
described in the "Specific Routing of Job Output to Pre-Defined 
Files", which follows. The user may also define a primary and 
alternate character set for each job. 








“YY 
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NOTE 


In order to route MRJE job output to an HP 2680A, the 
printer must be spooled and must have been configured 
with a device class of "LPS". 


It is not necessary to use Environment Files when directing out- 
put to the HP 2680; some or all of the output data sets froma 
job may be printed without using Environment Files. If Environ- 
ment Files are not used, output will be printed like ona 
standard printer. 


Do the following to print output using Environment Files: 


@ Log on to the HP: 3000 in the group and account which supports 
HP2680A environments. Sometimes :HELLO USER.SYS,ENV2680A will 
suffice. Check with your MRJE Manager or system manager for 
the user,group, and account names and passwords. Then, build 
your Environment Files. 


NOTE 


The names of Environment Files to be referenced by 
DSN/MRJE as special forms must be four characters long, 
or less. 


@ Enter the name of the file in the "forms" subparameter of the 
SYSOUT parameter in your job's JCL. (The "forms" subparameter 
is third subparameter of the SYSOUT parameter in the DD 
statement. ) 


e® Then, when your output is received from the host, DSN/MRJE 
will use the file named in "forms" to create the forms and 
print the output contained in the SYSOUT data _ set. lf 
DSN/MRJE is unable to find the Environment File, a forms mess- 
age for the data set will be sent to the console, asking the 
operator to mount special forms. 


e Different data sets in the same job can specify different 
Environment Files (or no file at all). 


If you are using alternate character sets, include the _ special 
codes needed to switch from one set to the other. The special 
codes may be "built into” each ASCII character in your data, or 
the ASCII Shift-In and Shift-Out characters may be embedded in 
the data to cause a shift from one set to the other. The special 
code is built into each character by turning the character's 
eighth bit on or off. When the bit is off, the character is 
printed from your primary character set; when the bit is on it is 
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printed from your secondary character set. As an alternative to 
this method, you may embed the Shift-In and Shift-Out characters 
in each data record wherever you want to switch between character 
sets. The Shift-In character (octal 17) causes the characters 
that follow to be from your primary set. Shift-Out (octal 16) 
causes the subsequent characters to be from your secondary char- 
acter set. Each Shift-In or Shift-Out remains in force until the 
end of the record, or until another Shift-In or Shift-Out charac- 
ter is encountered. 


If no special codes are included in your data, all characters 
will be printed from your primary character set. 


Environment Files cannot be specified for JCL message output. 
Example of the Use of Environment Files 


//EXAMPLE JOB (ACCOUNT) , PROGRAMMER 
//STEP EXEC PGM=TEST2680 

//MAINOUT DD SYSOUT=(A, , FOOL) 
//SECOUT DD SYSOUT=(A, , F002) 


In this example, the output for MAINOUT will be printed using 
Environment File FOO1.ENV.HP2680. The output for SECOUT will be 
printed using Environment File F002. ENV.HP2680. No forms-mount 
messages will be displayed when the output is printed. 


If DSN/MRJE is unable to find file F0O02.ENV.HP2680, a § forms- 
mount message for SECOUT will be displayed on the HP 3000 system 
console. 


Refer to "Interactive Formatting System Reference Guide", HP 
36580-90001, for more information on the use of Environment 
Files. 


Specific Routing of Job Output to Pre-Defined Files 


A user of the DSN/MRJE subsystem can route output to a configured 
device class or logical device number, or to an actual disc file. 
In addition, output from a job may be routed to a specific desti- 
nation, such as a printer with an output priority below the out- 
fence, or to an HP2680A Printer with a specific environment file, 
or to a tape with a particular blocking factor. Specific routing 
requires cooperation between the user who submits a job and the 
administrator of the system. 














Planning DSN/MRJE Jobs 


Cooperation between the DSN/MRJE subsystem user and the admini- 
strator takes place when the specific files to be routed are 
identified. The administrator of the system, when issuing an 
MRJECONTROL START, will reference the MRJESTRh file. Within that 
stream file there may.be FILE statements, each of which is ident- 
ified by a formaldesignator. (This reference is in one process.) 
The user of DSN/MRJE subsystem must identify those files where 
specific routing is to occur. Each specific file reference takes 
place within the user process, in a SUBMIT command when the 
PRINT, FORMS, or PUNCH parameters are used. Each of those para- 
meters may identify the formaldesignator previously specified by 
the system administrator. This is done by preceding the 
formaldesignator with an exclamation mark, "“I!". 


In the following example, within the job stream associated with 
an MRJECONTROL START command, the following file equation has 
been specified, 


:FILE HOLDLP;DEV=LP, 1 


:FILE ELITE; DEV=EPOC;ENV=ELITE.ENV2680A.SYS 


The formaldesiqnator in the file statement should not exceed 
seven characters. Now, a user of DSN/MRJE.in another job or 


session may specify the following 
#SUBMIT infile;PRINT=! HOLDLP ;FORM=! ELITE 


The effect of these coordinated statements is that a 
formaldesignator, HOLDLP, is available to all DSN/MRJE subsystem 
users as an output printer destination file whose destination 
device class is LP, and output priority is 1. In this instance, 
users of DSN/MRJE may list output spool files named HOLDLP asso- 
ciated with configured device class LP to their terminals by 
using the supported utility SPOOK, provided that the value of 
OUTFENCE is 0, and the output spool file is not active. Also, 
all special forms output will be routed to a formaldesignator 
"ELITE", a device in class "EPOC", most probably an HP 2680A 
Laser Printer, with a specified environment file 
ELITE. ENV2680A.SYS. 


Routing Default Output to Unsolicited Output Devices 


To route default output from a job to an unsolicited output 
device, set PRINT=0, PUNCH=0 or FORMS=0 in the SUBMIT command. 
This will supersede default output disposition, and route output 
to one of the unsolicited output disposition device classes or 
devices. 


Planning DSN/MRJE Jobs 


To submit a job with printer output to be sent to its default 
output device, use the command as follows: 


#SUBMIT Infile 


This identifies the printer output device from configuration out- 
put file item 20 as the printer output device. 


To submit a job with printer output to be sent to the unsolicited 
printer output devices use command as follows: 


#SUBMIT Infile;PRINT=0 


This identifies configuration file items 21 through 27, unsolici- 
ted print disposition for printers 1 through 7, as the output 
devices for printer data streams 1 through 7. If FORMS=0 ina 
SUBMIT command, then unsolicited output will be sent to the des- 
tination identified in items 21 through 27 also. 


If PUNCH=0 in a SUBMIT command, then unsolicited output will be 
sent to the destination identified in items 29 through 35 of the 
configuration file. 


It is possible to alter configuration file items 20 and 28, 
default printer and punch output disposition, and to set these 
values to zero. Then all default output would be sent to the 
unsolicited output destination devices. 


The customary use of unsolicited output devices continues to 
remain in force, so that unidentified job output will continue to 
be routed to unsolicited output devices. 


Configuration file items 21-27 and 29-35, the unsolici- 
ted output devices should always be set to legitimate 
values such as output device classes, logical device 
numbers, or pre-defined files. These items should never 
be set to 0. If these values are set to 0 then job out- 
put for these devices will be lost. 
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o Planning DSN/MRJE Jobs 


Routing Unsolicited Output to DSN/MRJE Unsolicited Devices 


Users may route output’ from jobs not submitted using DSN/MRJE to 
unsolicited output devices. Use the JCL appropriate to the host 
system. Specify an output class in either the MSGCLASS parameter 
of a JOB card or the SYSOUT parameter of DD card associated with 
a printer or punch stream. For example, if the output class for 
printer 3 is "K", use the following: 


//REROUTE JOB ... MSGCLASS=K ... 
or 


// DD SYSOUT= 
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COMMANDS AVAILABLE TO THE 
DSN/MRJE USER || 111 | 





This section describes the use of DSN/MRJE User commands’ for 
planning and submitting jobs. 


DSN/MRJE user commands are summarized in Table 3-1. In addition 
to those listed, the User may enter one or more host system con- 
sole commands, depending on how the configuration file for a 
given machine has been built. For more about console commands, 
refer to "HOST CONSOLE COMMANDS" at the end of this section. 


DSN/MRJE USER COMMANDS 


Before entering any User command, log onto the HP 3000 system and 
initiate DSN/MRJE execution with the :MRJE command. 


Table 3-1. Summary of DSN/MRJE User Commands 


job# Cancels one or more of 
CLANCEL] [JOB]] cores the User's jobs. 
joblist 


HCOST] 
, Job# Displays ID of current 
J[LOBLOG] ||, jobname host, status of User's 
DLISPLAY] ,joblist jobs, line status (open 
or closed), and infor- 
SCTATUS ] mation about host machine 


,item# configuration. 
CCONFIG] | j,itemlist 


Terminates DSN/MRJE and 
returns control to MPE. 


HELP [command name] Provides a means for users 
and managers of DSN/MRJE 
to obtain brief instruc- 
tions about how to use the 
subsystem commands. 





Commands Available to the DSN/MRJE User 


Table 3-1. 


Summary of DSN/MRJE User Commands (continued) 


COMMAND FUNCTION =m 


HLOST] Chostid) 


<host console command> 


SCUBMIT] infile[(options)] & 
eee £ infile[(options)] ] & 
C:;RCEADER]J=pseudo reader] & 
CePRCINTJ=[!lJprintfile[ (N 


I] 
pt hl ae he Senta id & 


C sFOLRMSJ=[ !]formfile[l (N) 


Specifies the host ma- 
chine that will be refer- 
enced by subsequent 


commands. 


A HASP, JES2, JES3, or ASP | 3-19 
command that will, in 

general, generate output o 
SSTDLIST. 


Enters a job for trans- 
mission to the current 
host. 


options = [N[OTRANSLATE][, TTRANSPARENT ] ] 
CTCRANSPARENT ](,NLOTRANSLATE J J 




















CANCEL 


Cancels one or more jobs. 


job# 


CCANCEL] [JCOBS]] jobname 
joblist 





The CANCEL command is used to cancel jobs that have been submit- 
ted for processing on the host. For jobs not yet transmitted to 
the host, CANCEL deletes the specified job number, name, or list 
from the reader spool file and marks the corresponding entry in 
the job log file as cancelled. If the job has been transmitted 
and the host is on-line when this command is issued, a cancel- 
lation command is sent to the host and the job log file entry is 
marked as cancelled. If the job has been transmitted but the 
host is off-line, the job log file entry is marked as cancelled; 
any output from the job that is received by DSN/MRJE when the 
communications line is re-opened will then be discarded. 


Parameters 


JOBS Optional parameter, provided for consistency with the 
DISPLAY command. Omitting JOBS has no effect. 


job# The number DSN/MRJE assigned to the User's job upon 
submission to DSN/MRJE. 


jobname The name on a JOB card in the User's input files. 


joblist A list of job names and/or job numbers. (See 
"Conventions", page xii.) 


Using CANCEL 


Since the CANCEL command always references the files that were 
created for the current host machine, it is advisable to issue 
the HOST command before issuing CANCEL. In this way, the User 
can be certain the proper job log file will be accessed. 


After the CANCEL command has been issued, DSN/MRJE displays the 
status of each specified job and requests confirmation that each 
job is to be cancelled. "YES" confirms the cancellation request, 
while any other response (including "Y") causes the command to be 
ignored. 


CANCEL 


Although a job may be referred to by its name or y its number, 
its number is preferable because it defines a unique job and 
results in a faster response. If a User specifies a job name for 
cancellation and more than one job with the same name has’ been 
submitted, DSN/MRJE will print: 


jobname: DUPLICATE JOBNAMES IN JOBLOG. CANCEL REFUSED. A DISPLAY 
OF JOBS WITH THIS NAME WHICH YOU OWN (IF ANY) FOLLOWS: 


The message is followed by a list of the User's jobs with the 
name and their assigned job numbers. No cancellation occurs even 
though all instances of the job belong to the User. 


Examples 


In the following example, two jobs are cancelled. The HOST com- 
mand has been entered first to be certain all commands reference 
the correct set of files: 


:MRJE 

HP 32192A.01.02 MRJE/3000 (C)HEWLETT-PACKARD CO. 1977 

USER CAPABILITY IN EFFECT 

#HOST P 

PLMS IS THE CURRENT HOST MACHINE 

#CANCEL 2,4 

--JOB#=2 JOBNAME=TEST2 USER=PAT.DCA,M 
PRINT="LP" PUNCH="LP" FORMS="LP" 
WAITING TRANSMISSION TO HOST 

VERIFY CANCEL WITH "YES" 

YES 

SPOOL FILE DELETED 

JOB#2 CANCELED 

-~-JOB#=4 JOBNAME=TEST4 USER=PAT.DCA,M 
PRINT="LP" PUNCH="LP" FORMS="LpP" 
WAITING TRANSMISSION TO HOST 

VERIFY CANCEL WITH "YES" 

YES 

SPOOL FILE DELETED 

JOB#4 CANCELED 











CANCEL 





The next example illustrates the execution of the CANCEL command 
when jobs exist with duplicate names: 


#CANCEL JOB TEST 
TEST: DUPLICATE JOBNAMES IN JOBLOG. CANCEL REFUSED. A DISPLAY 
OF JOBS WITH THIS NAME WHICH YOU OWN (IF ANY) FOLLOWS: 
--JOB#=11 JOBNAME=TEST USER=PAT.DCA,M 

PRINT="LP" PUNCH="LP" FORMS="LP" 

WAITING TRANSMISSION TO HOST 
--JOB#=20 JOBNAME=TEST USER=PAT.DCA,M 

PRINT="LP" PUNCH="LP" FORMS="LP" 

WAITING TRANSMISSION TO HOST 


This example shows the cancellation of a job already sent to’ the 
host. The communications link is currently open: 





#CANCEL JOB 3 
--JOB#=3 JOBNAME=MYJOB2 USER=PAT.DCA,M 
PRINT="LP" PUNCH="LP" FORMS="LP" 
“TRANSMITTED TO HOST WED, OCT 19, 1977, 3:20 PM HOST#=2018 
VERIFY CANCEL WITH "YES" 
YES 
$CJ2018, 2018 CANCEL COMMAND WILL BE SENT TO HOST 
$15.35.40 JOB 2018 ON RM.PR2 PRIO 9 PURGE 





The line above is.a response from the host system. 








DISPLAY 


Displays job and system information. 


HLOST] 


’ job# 
JLOBLOG] | |, jobname 
DLISPLAY] ,»joblist 


SCTATUS ] 


,item# 
CLONFIG] | |,itemlist 





The DISPLAY command is used to display the name of the current 
host, information about active and inactive jobs in the job log 
file, the status of the communications line to the host, or 
the contents of the configuration file for the current host. 


Use Control-Y in a session to halt the display of jobs and con- 
figuration file entries. 


Parameters 


HOST Lists the current host machine. This machine is 
referenced by any SUBMIT, DISPLAY, and CANCEL conm- 
mands until the User ‘issues the HOST command and 
selects another host machine. 


JOBLOG Displays information about jobs that were submitted. 
One of the three parameters, "‘job#", "jobname" or 
“joblist" must be specified. Use "“job#" if possible, 
because it identifies a specific job and using it re- 
sults in faster processing. 


STATUS Reports whether the communications line to the current 
host machine is open or closed. 


CONFIG Lists the contents of the configuration file for the 


current host machine. If the User includes item 
numbers, only the entries identified by the numbers are 
displayed. 


Item 4, Host Signon Card Image, is displayed only to 
MRJE Managers. 


(Item numbers are the numbers assigned to entries in 
the configuration file. All entries are listed and 
explained in Appendix A.) 























DISPLAY 


Using DISPLAY 


The DISPLAY command always references the set of DSN/MRJE files 
that were created for the current host system. To verify the 
identity of the current host system, use a DISPLAY HOST command 
before issuing any other commands which will affect any files. 


A User may only display jobs owned by the:user. If the User spe- 
cifies a job name in the JOBLOG parameter and it is not a_ unique 
name, only those instances of that job which belong to the User 
will be displayed. 


Examples 


In this example, information is requested about the status of a 
machine other than the default host machine: 


:MRJE 
HP 32192A.01.02 MRJE/3000 (C)HEWLETT-PACKARD CO. 1977 
USER CAPABILITY IN EFFECT 

#HOST P 

PLM2 IS THE CURRENT HOST MACHINE 

DISPLAY STATUS 

PLM2 IS OFF LINE 

TIME LINE DEACTIVATED=TUE, SEP 22, 1981, 4:38 PM 


In the next example the status of a series of jobs is checked: 


#DISPLAY JOB 5/7 

JOB#5 IS NOT YOUR JOB 

--JOB#=6 JOBNAME=TEST2 USER=PAT.DCA,M 
PRINT=USERPR NO TRANSLATION PUNCH="LP" FORMS=USERFORM 
WAITING TRANSMISSION TO HOST 

JOB#7 IS NOT YOUR JOB 


The communications link has been established in the next example. 
The example shows the status of a single job: 


#DISPLAY JOB 2 
--JOB#=2 JOBNAME=TEST1 USER=PAT.DCA,U 

PRINT="LP" PUNCH="LP" FORMS="LP" 

TRANSMITTED TO HOST WED, FEB 18, 1981, 4:05 PM HOST#=3022 
$DJ3022 DISPLAY COMMAND WILL BE SENT TO HOST. 
$14.11.32 JOB 3022 TEST1 EXECUTING PRIO 6 


The line above is a response from the host system. 
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EXIT 





Terminates DSN/MRJE and returns control to MPE. 


ECXIT] 


DSN/MRJE may be terminated at any time after its prompt 
(#) has been displayed. 








HELP 





Provides a brief description of how to use a DSN/MRJE subsystem 
command. 


HELP [command name] 





The HELP command is used to obtain brief general information and 
instructions about how to use DSN/MRJE subsystem commands. 


Use Control-Y in a session to halt the display from this command. 


Parameters 





command This parameter is optional. If absent a list of valid 
name DSN/MRJE commands is provided. If this parameter is 
present it may be any valid command name. 


Example 


In this example help is requested for the HOST command. 





#HELP HOST 


HLOST] [Lhostid] 
Select a particular host machine to be the current host 
machine. 











HOST 


Selects a particular host machine as the current host machine. 


H{LOST] [hostid] 





The system indentified by hostid in this command is referenced in 
all subsequent commands except for HELP and EXIT. 


Parameters 


hostid The name of a host machine for which the DSN/MRJE Manager — 
built a configuration file. The name can be spelled out 
or abbreviated to its first character. If this parameter 
is omitted, the default host system will be selected. 


Using HOST 


The HOST command need be used only if more than one host machine 
is connected to the HP 3000. In multi-host environments one host 


may be designated the "default host". A session is automatically 
associated with the default host when the :MRJE command is 
issued. A different host may be selected by using the HOST 


command. To return to the default host, the HOST command is 
issued without using "hostid". DSN/MRJE knows’ the default host 
only as “the default machine", and not by a host ID. Using a 
host ID in that situation may cause an error message to be sent 
to the User's terminal. 


Examples 


In the following examples, PLM is the name of the default host 
machine and COM2 is the name of a second host machine. 


#HOST 
DEFAULT HOST ASSUMED 
PIM IS THE CURRENT HOST MACHINE 


#HOST C 
COM2 IS THE CURRENT HOST MACHINE 








- SUBMIT 


& Submits one or more jobs to DSN/MRJE for transmission to host. 


SCLUBMIT] infile[ (options)] [,infile[ (options)]] ... & 
{[;RL[EADER]=pseudo reader] & 
C>:PRCINTJ=C!jprintfile[(N)J] & 

C;PULNCH]=[! ]punchfile[(N)]J] & 
C:FCORMSJ=[ !]formfile[ (N)]] 


options = N[{OTRANSLATE] [,T[RANSPARENT] ] 
TCLRANSPARENT] [,NCLOTRANSLATE] J] 





The SUBMIT command is the User's mechanism for submitting jobs to 
DSN/MRJE. If the DSN/MRJE communications line to the host is 
open, the jobs are sent directly to the host; if the line is not 
Open, and it has been configured with a spooled pseudo reader, 
the jobs are spooled until the line is brought up. 





Output from all the jobs submitted in a single SUBMIT command can 
be sent to a card punch, a printer using standard paper or _  spe- 
cial forms, or an HP 2680A Laser Printer. However, the SUBMIT 
command does not permit specification of more than one _ punch, 
more than one standard printer, or more than one special forms 
printer at a time. For instance, it is not possible to send out- 
put explicitly specified in a single SUBMIT command to a 
punchfile to two or more punches. 





The User must either take the default file for the output device 
category, or must specify a different file. The user may desig- 
nate a printfile, punchfile, or formfile value to be a zero (0). 
With a zero value, output will be sent to the unsolicited output 
destinations, as indicated in the configuration file. Display 
configuration file entries 20 and 28 to see the default values. 





Parameters 


(NCLOTRANSLATE ] ) “NOTRANSLATE" blocks translation of Infiles 
from ASCII to EBCDIC or EBCDIK or translation 
of output files from EBCDIC or EBCDIK to ASCII. 
Must be specified for each file that is not to 
be translated. 


Default translations are ASCII to EBCDIC for 
input to the host and EBCDIC to ASCII for 
output. 


SUBMIT 


(TTRANSPARENT ] ) 


infile 


pseudo reader 


Transparent transmission specifies that only 
the first JOB card of an Infile is identified, 
and that all subsequent ones from that Infile 
will be ignored by DSN/MRJE. If the TRANSPAR- 
ENT parameter is included, the proper JCL must 
still be included so the host will also treat 
the JOB cards as data. Use a proper DD card. 
You must be a Manager to use this option in 
with an Infile. 


A total of five Infiles may be specified. They 
are transmitted in the order listed in the 
SUBMIT command. Use of the TRANSPARENT option 
is limited to Managers. 


Each occurrence of the Infile parameter may be: 


@ An actual file designator (must be qualified 
if not owned by the _ logon group and 
account). 


@ A formal file designator which has been 
equated with one of the following: an 
actual file designator, a logical device 
number, a device class name, SSTDIN, 
SSTDINX, or SOLDPASS. 


e@ "SSTDIN", "S$STDINX", or "SOLDPASS". 


@ The logical device number of a real MPE in- 


put device. (This allows input from a 
source other than a terminal or disc file.) 


@ The device class name of a real MPE input 
device enclosed in quotes (e.g. "TAPE"). 


Neither the “NOTRANSLATE" parameter, nor _ the 
"TRANSPARENT" parameter may be specified for 
SSTDIN or SSTDINX input files. 


Used to specify the particular DSN/MRJE pseudo 
reader through which the jobs in the input 
files will be submitted. The user may input: 


@ The logical device number assigned an 
DSN/MRJE pseudo reader. 
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printfile 


punchfile 





formfile 





‘SUBMIT 


@e A pseudo reader device class name, enclosed 
in quotation marks. (This is acceptable 
only if the pseudo reader the user wants to 
use is the only reader configured with the 
device class name.) 


If the "READER=pseudo reader" parameter is 
omitted, the default pseudo reader listed in 
the configuration file of the current host 
machine is used. Display entry 19 of the con- 
figuration file to see default reader value. 


A pseudo reader can be used as an_  unspooled 
("hot") input device, thereby bypassing MPE 
spooling. In order to use a "“hot" pseudo 
reader, however, these conditions must be met: 
The pseudo reader must not be spooled; The 
pseudo reader must not be busy, but available; 
The communication line for the current host 
system must be open. 


Used to specify files that are to receive the 
results of job processing. One of each type of 
file can be specified by: 


@e The logical device number of an MPE output 
device. | 


@ An MPE device class name, enclosed in quo- 
tation marks. 


@® An unqualified actual file designator. (The 
file must reside in the logon group. and 
account. ) 


@ An exclamation mark prefixing a seven char- 
acter formaldesignator which conforms to the 
file name specifications of MPE, such as 
“tLOUTFILE". See the examples, below. 


@® A zero (0) character. 


The default output devices for print and punch 
files are given in the configuration file for 
the current host machine. (Display entry num- 
bers 20 and 28 of the configuration file to see 
what the default output devices are.) The 
default for "formfile" is always identical to 


the “printfile" default. 


SUBMIT 


Specific routing of job output to pre-defined 
files will occur when a printfile, punchfile, 
or formfile is identified with an exclamation 
mark followed by a legitimate seven character 
designation. This refers to a FILE statement 
in the MRJESTRh file. See the discussion on 
“Specific Routing of Job Output to Pre-Defined 
Files" in Section 2. 


Whenever a printfile, punchfile, or formfile is 
a zero character, then output will be routed to 
the printer or punch device associated with the 
Output stream. See the discussion on "Routing 
Default Output to Unsolicited Output Devices" 
in Section 2. 


Output sent to spooled output devices will be 
owned by the user and account of the submitter. 


Using SUBMIT 


Jobs are always submitted to the current host machine. Unless 
the HOST command has been used to specify another host, the 
current host will always be the default host. It is a good 
practice to precede the SUBMIT command with the HOST command to 
make certain jobs go to the right host. 


Actual and formal file designators used to specify Infiles can be 
qualified names. Actual file designators used for "printfile", 
“punchfile", and "formfile", may never be qualified names. If a 
printfile, punchfile, or formfile is an exclamation mark followed — 
by a legitimate designation, then specific routing of job output 
may take place. See Section 2. If the printfile, punchfile, or 
formfile is a zero character, then default output will be routed 
to unsolicited output devices. See Section 2. 


The parameter “PRINT=printfile" specifies the destination of 
print output generated by the jobs submitted in one SUBMIT 
command. 


The parameter "PUNCH=punchfile" specifies the destination of 
punch output generated by the jobs submitted in one SUBMIT 
command. 


The parameter "“FORMS=formfile" specifies the destination of 
output requiring special forms that was gen ated by the jobs 
submitted in one SUBMIT command. This parameter ay be used only 
once in the SUBMIT command, regardless of the number of different 
forms called for in the host system job control language (JCL). 














SUBMIT 


If the FORMS parameter is omitted but a job's JCL calls for spe- 
cial forms, the output is sent to the default print device given 
in the configuration file. If the default print device is a line 
printer, the output is printed on that machine in the format of 
the special form (i.e., as if the form had been mounted on the 
printer). 


The READER parameter can be used to select a pseudo reader other 
than the DSN/MRJE default reader for job input. (Do not confuse 
the pseudo reader with a physical card reader that is attached 
peripherally to the HP 3000.) Normally the default reader is 
spooled, so jobs can be submitted without concern for whether the 
communications link with the host system has been established. 
If the user wishes to submit jobs without spooling (i.e., ‘hot'), 
an unspooled pseudo reader must be used and the communications 
line to the current host must be open. A reader other than the 
default reader is specified in the SUBMIT command through the 
READER parameter. (If the default reader is not spooled, the 
parameter need not be used for "hot" job submission. ) 


Whenever jobs are submitted through an unspooled pseudo reader, 
the communications line to the host must be open in order for the 
SUBMIT command to execute successfully. 


There are two options allowed for Infiles and FD files, 
NOTRANSLATE and TRANSPARENT. When the NOTRANSLATE option is used 
with an Infile or an FD file, the data to be sent to the host 
system is not translated from ASCII to EBCDIC (or BCDIK), which 
allows for the transmission of data already translated, or which 
should not be translated. A good example of data which should 
not be translated is packed decimal information. When the 
TRANSPARENT option is used with an Infile only the first JOB card 
in that Infile is identified, and all subsequent ones will be 
ignored by DSN/MRJE. You must be a Manager to use the 
TRANSPARENT option with an Infile. When the TRANSPARENT option 
is specified with an FD card, then all JOB cards will be ignored 
by DSN/MRJE. Proper JCL must always be included whenever’ the 
TRANSPARENT option is for the host to treat the JOB cards as 
data. Use a proper DD card. One reason for submitting a JOB to 
a host as data is to enable a host system to engage in the condi- 
tional execution of a job. 


As DSN/MRJE processes a SUBMIT command, it checks all input files 
and those FD files for which the transparency parameter (T) was 
not included on the ##FD card. Each time the subsystem encoun- 
ters a JOB card, it assigns a unique job number and enters’ the 
number in the job log file for the current host machine. The job 
numbers are returned to the User in S$STDLIST so they can be noted 
for future reference to individual jobs. 


SUBMIT 


When input originates from $STDIN or SSTDINX, the end of every 
file must be marked with an MRJEOD record. This record must con- 
tain the characters "MRJEOD" in the first six columns; it will be 
read by DSN/MRJE, but will not be sent to the host. 


The ampersand character (&) may be used in the SUBMIT command, as 
often as needed, as a line continuation character. If used, it 
must be placed after a file name (or after the "NOTRANSLATE"/ 
“TRANSPARENT” parameters, if these are specified for that file). 


If output from one or more of your jobs is treated by MRJE as 
unsolicited when you had correctly specified an output destina- 
tion, check with the MRJE Manager or the system operator. The 
Joblog file may have been re-initialized since the time your jobs 
were sent to the host. 


Output directed to an HP 2680A Laser Printer may be printed with 
or without Environment Files. If Environment Files are used they 
must be named in the “forms" sub-parameter of the SYSOUT para- 
meter of the DD statement in your job's JCL. Refer to Section 
II, “Printing Output on an HP2680 Laser Printer" and "Specific 
Routing of Job Output to Pre-Defined Files" for more information. 


Examples 


In the following example, two jobs are submitted to the default 
host machine: 


#SUBMIT TEST1, TEST2 

JOB#=5 JOBNAME=JOB1 RECORDS READ=7 RECORDS WRITTEN=7 
DEFAULT IS OFF LINE 

JOB#=6 JOBNAME=JOB2 RECORDS READ=15 RECORDS WRITTEN=14 
DEFAULT IS OFF LINE 


In the next example, output file specification is illustrated: 


#SUBMIT TEST10(N) ,TEST11;PRINT=MGRPR;PUNCH=MG PUN;FORMS=FORM 
JOB#=7 JOBNAME=JOB3 RECORDS READ=20 RECORDS WRITTEN=20 
DEFAULT IS OFF LINE 
JOB#=8 JOBNAME=JOB3 RECORDS READ=7 RECORDS WRITTEN=7 
DEFAULT IS OFF LINE 
#DISPLAY JOB 7,8 
--JOB#=7 JOBNAME=JOB3 USER=JIM.DCA,WILLITS 

PRINT=MGRPR PUNCH=MGRPUN FORMS=FORM 

WAITING TRANSMISSION TO HOST 
--JOB#=8 JOBNAME=JOB3 USER=JIM.DCA,WILLITS 

PRINT=MGRPR PUNCH=MGRPUN FORMS=FORM 

WAITING TRANSMISSION TO HOST 





SUBMIT 


In the following example, specific routing of job output to pre- 
defined files is illustrated. Assume the job in execution with 
an MRJECONTROL START command in force. 


{JOB MRJESTR, MANAGER. SYS 

}COMMENT THIS JOB WILL ALLOW USERS TO ROUTE OUTPUT TO 
!COMMENT AN HP2680 WITH A SPECIFIC ENVIRONMENT. 

IFILE ELITE;DEV=LPS ;ENV=ELITE.ENV2680A.SYS 

!RUN MRJEMON;INFO=" " 

!EOJ 


:HELLO USER.ACCOUNT 


:MRJE 
HP 32192A.02.00 MRJE/3000 (C) HEWLETT-PACKARD CO. 1982 


USER CAPABILITY IN EFFECT 


#SUBMIT SSTDIN;PRINT=! ELITE 





° 


The following example illustrates routing of default output to 
unsolicited output devices: 


#SUBMIT $STDIN;PRINTER=0 





The following example illustrates the use of MRJEOD: 





!JOB NEWJOB, PLM. DOC (Standard MPE job card.) 

IMRJE (Calls DSN/MRJE. ) 

SUBMIT SSTDIN (Submits JOB1 to the default host 

//3JOB1 JOB machine from a batch input device.) 

/* 

MRJEOD (Specifies end-of-fil to MRJE.) 

DISPLAY JOB1 (Displays job status on the standard 
list device, a line printer.) 

EXIT (Exits MRJE.) 

!EOJ (Terminates stream job.) 


Note that if MRJEOD is put on an input disc or tape file, the 
image will not not transmitted, either. 





SUBMIT 


The following example illustrates the use of the TRANSPARENT 
option. Assume that a ‘catalog’ file is to be stored on the host 
system disc, and that it is to contain a job named "CATALOG". 
The user should submit a job as follows: 


#SUBMIT INPUT (TRANSPARENT) The contents of file "INPUT" 
follow: 
//JOB1 JOB ( ... ) DSN/MRJE will recognize "JOB1". 
//SYSUT1 DD DATA, DLM=S$$ This must precede other jobs. 
//CATALOG JOB ( ... ) This job will not be 
‘ recognized. 
$$ Terminates data. 
* Terminates "JOB1" 
MRJEOD Terminates input for SUBMIT. 
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HOST CONSOLE COMMANDS 


A DSN/MRJE User can issue the host console commands that are 
allowed in the current DSN/MRJE configuration file. If the DSN/ 
MRJE Manager has configured only a single character (for example, 
$), the User can enter commands beginning with that character. 
On the other hand, if a specific command is configured (for 
example, $DJ), only that console command is available to the 
User. The DSN/MRJE Manager can only give the DSN/MRJE User 
access to commands that remote consoles have access to. This 
means that the User may not be able to use all the commands that 
can be entered at the host system master console. 


The User can display items 6 and 7 of the current configuration 
file (using the DSN/MRJE command DISPLAY) to see what console 
commands are available for use. 


Host Console Commands: 


@ May be issued interactively while the communications line is 
active. 


@ May be issued as part of an IBM JCL deck. 


@ Must conform to the format and restrictions of the host sys- 
tem. 


@ Will be refused if any other User (including the Manager) is 
currently communicating with the host system. 


The host console commands usually generate a listing or other 
response $STDLIST. Because the host console may communicate with 
only one terminal at a time, DSN/MRJE limits the User's listings 
to the configured host buffer size, regardless of the command 
entered. (This permits other terminal users to enter host con- 
sole commands and receive responses as well.) Control-Y can be 
used to halt a listing and to obtain a DSN/MRJE prompt for input 
(#). Host console commands issued by DSN/MRJE Users may 
occasionally be refused due to heavy console message traffic from 
the host system, or because someone else is using the console. 


Example 


#SDJ3022 
$14.11.32 JOB 3022 TEST1 EXECUTING PRIO 6 





: 


™?. 











SECTION 





MANAGING DSN/MRJE 





This section addresses the DSN/MRJE Manager, who plans data com- 
munication facilities, configures the DSN/MRJE subsystem, manages 
subsystem activities, and coordinates DSN/MRJE with the Users who 
have been authorized to use the distributed console command 
s:MRJECONTROL or its equivalent. 


The DSN/MRJE Manager must have MPE System Supervisor (OP) capa- 
bilities and must be able to log on to MANAGER.SYS. The NEW and 
PURGE ALL commands can only be issued by MANAGER.SYS. All other 
commands described in this section can be issued from any logon 
account and group by any user with OP capability. 


DSN/MRJE HARDWARE 


In addition to an HP 3000 computer, DSN/MRJE hardware includes: 


@ One or more communications line to one or more remote hosts. 
The lines may be switched or leased and require two compatible 
modems (one at each end of the line). 


@® One communications controller for each communications line to 
be used by DSN/MRJE at a given moment. 


@® Terminal(s), card reader(s), and/or tape drive(s) for communi- 
cating with DSN/MRJE and submitting jobs. 


The Communications Controllers 


DSN/MRJE operation requires the existence of a communications 
interface in your HP 3000 Computer. The interface can be an HP 
30020A/B Intelligent Network Processor (Series 30/33/40/44/64/ 
INP) an HP 30010A Intelligent Network Processor (Series II/III 
INP), or an 30055A Synchronous Single-Line Controller (Series 
II/III SSLc). After the controllers have been installed by 
Hewlett-Packard, they must be configured into the MPE I/O system 
as described in Appendix D. 


Modems 


Modem recommendations and strapping specifications are given in 
Appendix C of this manual. 
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DSN/MRJE SOFTWARE 


DSN/MRJE software supports two pseudo line monitors, a pseudo 
operator's console, and up to seven pseudo card readers, seven 
pseudo line printers, and seven pseudo card punches. They are 
configured into the MPE I/O System as described in Appendix D. 


BUILDING THE DSN/MRJE MANAGEMENT FILES AND OTHER 
DSN/MRJE FILES 


The DSN/MRJE management files are the config ration file, 
MRJECONh (where h is the first character of the host identifica- 
tion), the job log file, MRJEJOBh, and the Girectory file, 
MRJEDIRh. These are other files associated with the DSN/MRJE 
subsytem: the message catalog file, MRJECAT; the stream file, 
MRJESTRhn; the message file, MRJEMSGh. 


Once DSN/MRJE and the communications controller(s) have been con- 
figured into MPE, the DSN/MRJE management files and other DSN/ 
MRJE files are built. The procedure is as follows: 


1) Log onto the HP 3000 as MANAGER.SYS 


2) Give MANAGER.SYS "OP" capability if it doesn't already have 
it. Log on again as MANAGER.SYS to alter both the account 
and the user. 


3) Verify that the message catalog file, MRJECAT, exists and 
contains information and error messages for the DSN/MRJE sub- 
system. Either the EDITOR or FCOPY subsystem will provide a 
way to do this. 


4) Build a stream file, MRJESTRh, for each configured host sys- 
tem. The stream file is used whenever an MRJECONTROL START 
command is issued. The contents of file MRJESTRh are such 
that the monitor process MRJEMON will. be executed. The 
stream file must contain the command RUN MRJEMON;INFO="h", 
where ‘h' is the first letter of the host identification. In 
the case of a default host the character ‘h' must be a blank. 
In addition, the stream file may contain FILE statements 
to which users of the DSN/MRJE subsystem may refer when spe- 
cifically routing job output. See "Specific Routing of Job 
Output to Pre-Defined Files," in Section 2, as well as the 
description of the submit command in Section 3. 


+ 
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For example, 


: EDITOR 
HP32201A.7.10 EDIT/3000 FRI, FEB 19, 1982, 3:30 PM 
(C) HEWLETT-PACKARD CO. 1981 








fa 

— MANAGER .SYS ;HIPRI ; RESTART ; TIME=? 

! COMMENT THIS JOB WILL ALLOW USERS TO ROUTE OUTPUT TO 
! COMMENT AN HP2680 WITH A SPECIFIC ENVIRONMENT. 

! COMMENT ALSO, THE STACK DUMP FACILITY IS ARMED TO 

! COMMENT OPERATE WHEN AN MRJEMON PROBLEM OCCURS. 


{FILE ELITE ;DEV=LPS ; ENV=ELITE.ENV2680A. SYS 
!FILE HOLDLP;DEV=LP,1 

!SETDUMP DB,ST 

'RUN MRJEMON;INFO=" " 

IEOJ 

ft 

/keep mrjestr 

fexit 


eo ¢ 








5) This is optional. Create a message file, MRJEMSGh. The 
*h? is the first letter of the host identification. This is not 
the message catalog file, described in step 4, above. The file 
MRJEMSGh receives host console messages, output messages from the 
host system, and a performance measurement data record on output 
data received. The message file may be a system file, or an 
actual file. If this file does not exist all messages are lost. 
The subsystem will continue operating. 


These ways can be used to specify an MRJEMSGh file: 


® Use a FILE equation with the process used to run_ the 
DSN/MRJE monitor. This is a sample for host id "X”", 


:FILE MRJEMSGX=$STDLIST 
This statement should be in a stream job like step 4. 

® Build a circular type of file. This is useful when the 
most recent set of messages from the host system need to 
be retained. The following is an example for host 
identification "B': 
: BUILD MRJEMSGB;REC=-80,16,F ,ASCII;DISC=1024,8,8;CIR 
This message file can hold the 1024 most recent messages 
from host "B"; however, this file can not be read until 


communication with the host system has ceased, or it is 
not accessed by any process writing to it. 
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a Build a ‘pipe’ or ‘message’ file. This is useful when 
it is desirable to read the oldest message while writing 
to the file. The following is an example for a default 
host: 


: BUILD MRJEMSG;REC=-80, ,V, ASCII ;DISC=2048 ,8,8;MSG 
These limitations apply: 


Messages are discarded if this type of message file is 
filled, and there are no active process reading it. 


Communication to the host will be suspended when this 
type of file is full, or until all processes reading 
this type of message file have closed the file. 


A record ceases to exist once it has been read. (One 
process may be reading from this file while another is 
writing to it.) 


Initially the most desirable type of MRJEMSG file for use at an 
installation may be one equated to $STDLIST because these are 
output spooled records. 


Both the MRJELOGR and MRJEOUT processes write to a MRJEMSG file. 
The file is opened with shared and append access. If this file 
is not accessible, then messages intended for it are lost, and 
DSN/MRJE operations continue normally. 


6) Enter :MRJE, the MPE command to start execution of DSN/MRJE. 


The subsystem will then display the DSN/MRJE banner, a message 
confirming that Manager capability is in effect, and _ the 
DSN/MRJE prompt for input. For example: 


>MRJE 

HP32192A.01.01 MRJE/3000 (C)HEWLETT-PACKARD CO. 1980 
MANAGER CAPABILITY IN EFFECT 

oe 





7) Next, build the DSN/MRJE management files using the NEW 
command. 


When NEW executed, it requests the following information: 
@ The number of jobs the job log file will be permitted to 
accommodate. 


@ The name assigned to the host machine (host ID). None need be 
assigned when building management files for the default host. 
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® The type of host Job Entry Subsystem (HASP, JES2, JES3, or 
ASP). 


® The signon card format. 


@ The logical device numbers that were assigned to the pseudo 
console device and to the pseudo line monitor during MPE con- 
figuration. 


e The format of the host system console command (or _ commands) 
Users will be permitted to enter. 


® If communications with the host will be over a switched line 
without auto-dialing then a telephone number will be displayed 
at the HP 3000 system console whenever a :MRJECONTROL START 
command is issued for this line. The telephone number is for 
the modem at the host system. 


NOTE 


Communications may also take place over a switched line 
with auto-dialing, provided that an HP 30020B INP, and a 
Bell 801C auto-dialing unit, and an HP 30221G connecting 
cable are used. Telephone numbers may be supplied in 
the DSN/MRJE configuration file, as well as in the MPE 
configuration of the INP. The DSN/MRJE telephone nun- 
ber, if present, will take precedence over the config- 
ured telephone number. Under these circumstances no HP 
3000 system operator message for dialing will be 
displayed. 


After the Manager responds to the prompts, DSN/MRJE initializes 
the job log and directory files, and initializes part of the-con- 
figuration file, using the information just provided by the 
Manager. 


The remainder of the configuration items are initialized with 
DSN/MRJE default values which can be changed later with the ALTER 
command. Formats and default values for the configuration file 
are discussed in Appendix A. 


Before any jobs are submitted to the host, you will need to exam- 
ine some of the configuration file default values, particularly 
those pertaining to the host print and punch banners and to the 
host console "ON" message (Items 8-13 and 37, and Items 15-17, 
respectively). Lf the default values do not correctly describe 
what your host does, change them using the ALTER command. 
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If you do not know what your host's banners look like, alter 
Items 8 and 9 to a value of "0". (Item 8 is the number of lines 
to check for print banner; Item 9 is the number of cards to check 
for punch banner.) Leave the destination for unsolicited print 
and punch output (Items 21-27 and 29-35) configured as "LP". (If 
the printers you will be using have been configured into your HP 
3000's I/O system with a device class name other than "LP", 
change Items 21-27 and 29-35 to the name used in the I/O configu- 
ration.) Then submit a dummy job to the host for the creation of 
punch and print output. The output will return as "unsolicited", 
and the full banners will be printed. Using a ruler, you can 
count columns to find values for Items 10-13. You will also see 
from the output what values to enter for Items 8 and 9. 


To find values for Items 15-17, it will be necessary to open com- 
munications with the host and to go into Console Command Mode 
(described later in this section under "HOST CONSOLE COMMANDS"). 
Then, from another terminal, submit a dummy job and capture the 
"ON" message on your "Console Mode" terminal. 


See “CAUSES AND CONTROL OF UNSOLICITED OUTPUT" at the end of this 
section. 


MAINTENANCE OF MANAGEMENT FILES 


DSN/MRJE Configuration, Job Log, and Directory management files 
are created with permanent and modifiable information. The modi- 
fiable information in the configuration file may be changed using 
the command ALTER; entries may be deleted from job log files by 
using the PURGE command; the NEW command can be used to purge and 
rebuild configuration files and their associated job log and 


directory files. 
NOTE 


The Configuration, Job Log, and Directory files can not 
be altered if they are in use. There are two situations 
when management files are in use, when the associated 
communications line is active, and when another user is 
referencing one of these files. 


The Message Catalog File, Message File, and Job Stream Files may 
be maintained as described below. 
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Configuration File 


When the MPE I/O system configuration is altered in a way that 
affects DSN/MRJE, its configuration files may have to be modified 
to reflect the change. Some items in the file can be modified 
using the ALTER command, while others are fixed when the file is 
initialized, thereby making it necessary to re-create the file in 
order to change the items. In table A-l (refer to Appendix A), 
items that cannot be altered are indicated by Note l. 


If a NEW command specifies a host machine for which management 
files already exist, DSN/MRJE prints the name of the existing 
configuration file and asks if it is all right to recreate it. 
After a YES response, DSN/MRJE deletes the three DSN/MRJE manage- 
ment files currently associated with the host and creates three 
new ones. 


The Job Log File 


One job log file is associated with each DSN/MRJE configuration 
file. The job log file is used by DSN/MRJE to maintain a record 
of each job submitted to the subsystem for transmission to the 
host defined in the configuration file. The job log is built 
automatically when the Manager uses the NEW command to create the 
configuration file and is limited to a size specified by the Man- 
ager during execution of NEW. 


The DSN/MRJE Manager can purge entries from a job log file using 
the PURGE command and can thus maintain space in the file for new 
jobs. When the file is full, DSN/MRJE will reject new jobs. 
PURGE ALL causes all entries to be deleted from the file; PURGE 
OLDJOBS deletes only those jobs that have been cancelled, have 
"timed-out", or were not transmitted successfully to the host. 


It is not possible to expand the job log file once built. The 
only way to have a larger file is to build it over using the NEW 
command. (This means building a new configuration file, too.) 


Directory File 


This file requires no maintenance; it is used by DSN/MRJE as an 
index to the job log file. 
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The Message Catalog File 


The Message Catalog File is an MPE catalog file used by DSN/MRJE 
for almost all of the messages sent to users and to the system 
operator. Any modification the Message Catalog File, 
MRJECAT.PUB.SYS, should be done according to MPE specifications. 
See Section 6. 


The Message File 


The Message File is used to receive host console messages, and 
other information. If the Message File is an actual file, such 
as MRJEMSGh.PUB.SYS, information may be read from it. Considera- 
tion must be given to the kind of file being used because infor- 
mation could be inadvertently destroyed or lost. See above, 
"BUILDING THE DSN/MRJE MANAGEMENT FILES AND OTHER DSN/MRJE 
FILES". 


The Job Stream File 


The Job Stream File, MRJESTRh.PUB.SYS, is used whenever an 
MRJECONTROL START command is issued. This file m st contain the 
command RUN MRJEMON;INFO="h", where ‘h' is the first character of 
the host identification, or a blank character. Other commands 
may be included in a Job Stream File. Maintenance of this file 
may take place at any time except when a the job is being intro- 
duced, and the Job Stream File is busy. See "BUILDING THE DSN/ 
MRJE MANAGEMENT FILES AND OTHER DSN/MRJE FILES", above, and the 
"MPE Commands Reference Manual" (30000-90009). 


LISTING MRJE JOB OUTPUT ON THE HP 2680A LASER PRINTER 


If MRJE users will be routing job output to an HP 2680A Laser 
printer, the printer must be configured into the MPE I/O system 
with a device class of "LPS" and must be spooled. 


If MRJE users will be listing special forms output on the HP 
2680A using Environment Files, the MRJE Manager will need to 
build the HP2680 account and the ENV group in the account; MRJE 
looks for Environment Files in ENV.HP2680. The account and group 
need default capabilities only. Users who wish to build their 
own Environment Files need write access to ENV.HP2680. 
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MANAGER COMMANDS 


The DSN/MRJE Manager commands are summarized in table 4-1, below. 
These commands are used during an MRJE session to configure 
DSN/MRJE and to supervise its use. Refer to the page numbers 
indicated for more detailed descriptions of each command. 


The DSN/MRJE Manager can use all the User commands and has access 
to all host console commands available to a remote console. See 
the discussion in Section 3, and "CONVENTIONS" on page xi. 


Table 4-1. Summary of DSN/MRJE Manager Commands 


COMMAND FUNCTION PAGE 


ALLTER] Jitem# Specifies the items to 
itemlist be changed in the con- 
figuration file. 


























job# 
CLANCEL] [J[OBS]] { jobname 
joblist 













Cancels one or more jobs. | 4-11 








H{COST] 











Displays name of current- 








, JOb# ly selected host machine, 
JCOBLOG] |, jobname status of current and old 
,joblist jobs, line status (open 
D[LISPLAY] or closed) and subsystem |4-14 
O[LLDJOBS ] configuration 
SCTATUS ] information. 
CONFIG] an | 
,itemlist 


host console command> Transmits a HASP, JES2, 
JES3, or ASP command to 
the host system. Output 
may be received at 
SSTDLIST. 


NCEW] [Chostid] Used to build or rebuild 
an DSN/MRJE configura- 
tion file. 

PLURGE] O[{LDJOBS] Purges entries from the 

ALLL] job log file. 
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ALTER 


Used to modify entries in a configuration file. 


ALLTER] item# 


itemlist 





Parameters 

item# The number assigned to an entry in the configuration 
file. Some entries cannot be altered. These are 
indicated in Appendix A, Table A-1, by note l. 


itemlist A list of item numbers. 


Using ALTER 


Configuration file entries and their corresponding item numbers 
are shown in Appendix A. 


The ALTER command always references the configuration file for 
the current host machine. 


If the number of an unmodifiable entry is entered, DSN/MRJE will 
print an error message. 


When the command executes, DSN/MRJE prints the description and 
current value of a designated item and then prompts for a new 
value. Enter a new value in the format shown in Appendix A, or 
type a carriage return to retain the current value. 
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ALTER 


Examples 


The following example shows changes in the logical device numbers 
for the default host machine after a change in MPE configuration. 
(Note that the HOST command was issued before ALTER to be certain 
the command would reference the correct set of files.) 


:MRJE 
HP 32192A.01.02 MRJE/3000 (C)HEWLETT-PACKARD CO. 1977 
MANAGER CAPABILITY IN EFFECT 
#HOST 
DEFAULT HOST ASSUMED 
PLM IS THE CURRENT HOST MACHINE 
#ALTER 2,3 
2. PSEUDO CONSOLE DEVICE=042 


NEW VALUE= 
46 
3. PSEUDO LINE MONITOR DEVICE=040 


NEW VALUE= 


44 
MRJECON SUCCESSFULLY ALTERED 


In the next example, an attempt has been made to change the 
number of entries a job log file can accommodate. The attempt 
failed because the size of the job log file cannot be altered 
without rebuilding the configuration file: 


#HOST C 
COM2 IS THE CURRENT HOST MACHINE 


#ALTER 18 
18. MAXIMUM NUMBER OF JOBLOG ENTRIES=150 
THIS ITEM NOT DYNAMICALLY CONFIGURABLE 


MRJECONC NOT ALTERED 


Note that because COM2 is a machine other than the default host 
machine, the configuration file name is MRJECONC. 
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CANCEL 


Cancels one or more jobs. 


job# 
CCANCEL] [J[OBS]] jobname 


joblist 





The CANCEL command is used to cancel jobs that have been submit- 
ted for processing on the host. For jobs not yet transmitted to 
the host, CANCEL deletes the specified job number, name or list, 
and marks the corresponding entry in the job log file as cancel- 
led. If the job has been transmitted and the host is on-line when 
this command is issued, a cancellation command is sent to the 
host and the job log file entry is marked as cancelled. If the 
job has been transmitted but the host is off-line, the job log 
file entry is marked as cancelled; any output from the job that 
is received by DSN/MRJE when the communications line is re-opened 
will then be discarded. 


Parameters 

JOBS Optional parameter, provided for consistency with the 
DISPLAY command. Omitting JOBS has no effect. 

job# The number DSN/MRJE assigned to a job at submission. 

jobname The name on a JOB card in an input file. 

joblist A list of job names and/or job numbers. 


Using CANCEL 


Since the CANCEL command always references the files that were 
created for the current host machine, it is advisable to issue 
the HOST command ahead of CANCEL to be certain the proper job log 
file will be accessed. 


Following a CANCEL command, DSN/MRJE displays the status of the 
specified job(s) and asks for cancellation confirmation. A YES 
response confirms the cancel request while any other response 
(including Y) causes the command to be ignored. 
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CANCEL 


Although either the number or the name of a job may be specified, 
the number is preferable because it defines a specific job and 
gives a faster response. If a job name is specified for cancel- 
lation and more than one job with the same name has been’ submit- 
ted, DSN/MRJE will print: 


jobname: DUPLICATE JOBNAMES IN JOBLOG. CANCEL REFUSED. A DISPLAY 
OF JOBS WITH THIS NAME WHICH YOU OWN (IF ANY) FOLLOWS: 


This is followed by a list of all jobs with the given name and 
their assigned job numbers. No cancellation occurs. Thus, in 
the case of duplicate job names, the CANCEL command should 
include the job number, which is unique, rather than the job 
name, which is not. 


Examples 


In the first example, job number 25 has been cancelled. (Note 
that the HOST command was issued first to be certain the command 
referenced the correct set of files): 


sMRJE 

HP 32192A.00.00 MRJE/3000 (C)HEWLETT-PACKARD CO. 1977 

MANAGER CAPABILITY IN EFFECT 

#HOST P 

PLM2 IS THE CURRENT HOST MACHINE 

#CANCEL 25 

--JOB#=25 JOBNAME=TESTJOB2 USER=PAT.DCA,M 
PRINT="LP" PUNCH="LP"  FORMS="LP" 
WAITING TRANSMISSION TO HOST 

VERIFY CANCEL WITH "YES" 

YES 

SPOOL FILE DELETED 

JOB#25 CANCELED 


CANCEL 


In the next example, three jobs have been cancelled with one 
command : 





#HOST 
DEFAULT HOST ASSUMED 
PLM IS THE CURRENT HOST MACHINE 
#CANCEL 22,3/4 
-~JOB#=22 JOBNAME=MYJOB USER=PAT.DCA,M 
PRINT=USERPR NO TRANSLATION PUNCH="LP" FORMS=USERFORM 
WAITING TRANSMISSION TO HOST 
VERIFY CANCEL WITH "YES" 
YES 
SPOOL FILE DELETED 
JOB#22 CANCELED 
--JOB#=3 JOBNAME=MYJOB2 USER=PAT.DCA,M 
PRINT="LP" PUNCH="LP" FORMS="LP" om 
WAITING TRANSMISSION TO HOST ™ 
VERIFY CANCEL WITH "YES" 
YES 
SPOOL FILE DELETED 
JOB#3 CANCELED 
~-JOB#=4 JOBNAME=MYJOB3 USER=PAT.DCA,M 
PRINT="LP" PUNCH="LP" FORMS="LP" 
TRANSMITTED TO HOST WED, OCT 19, 1977, 3:20 PM HOST#=2018 
VERIFY CANCEL WITH "YES" _ 
YES . 2 
$C72018, 2018 CANCEL COMMAND WILL BE SENT TO HOST. | 
$15.35.40 JOB 2018 ON RM31.PR2 PRIO 9 PURGE 
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DISPLAY 


Displays job and system information. 





HLOST] 


, JOb# 
JCLOBLOG] |, jobname 
DCISPLAY] ,joblist 


O[LLDJOBS ] 

SCTATUS ] 

CLONFIG] ,»item# 
,itemlist 





The DISPLAY command is used to display the name of the current 
host, information about active and inactive jobs in the job log 
file, the status of the communications line to the host, or the 
contents of the configuration file for the current host. Use 
Control-Y in a session to halt the display of jobs and configura- 
tion file entries. 





Parameters 


HOST Lists the current host machine This machine is 
referenced by the SUBMIT, DISPLAY, ALTER, PURGE, and 
CANCEL commands until the HOST command is issued to 
select another machine. 





JOBLOG Displays information about jobs. If neither "job#", 
“jobname", nor "“joblist" is specified, the entire job 
log file for the current machine is displayed. 


JOBLOG is the default parameter for the DISPLAY 


command. 
( OLDJOBS Purges entries for cancelled jobs and jobs that have 
"timed-out". Timed-out jobs are jobs that have been 


in the job log file for a period of time, equal to or 
greater than the time limit configured in item 42 of 
the configuration file. The time limit is measured 
from the point of successful transmission to the host. 


STATUS Reports whether the communications line to the current 
host machine is open or closed. 


CONFIG Lists the contents of the configuration file for the 
current host machine. If item numbers are included, 
only the corresponding entries are displayed. (See 
Appendix A for descriptions of the configuration file 
entries.) 





DISPLAY 


Using DISPLAY 


The DISPLAY command always references the set of files that were 
created for the current host machine. 


If a generic job name is specified with the JOBLOG parameter, all 
instances of that job name are displayed, whether they belong to 
one or several users. 


If the DISPLAY JOBLOG command is entered with "jobname", "Job#", 
or "joblist" during an interactive session and while the communi- 
cations link is connected, DSN/MRJE sends a display command to 
the host to obtain the status of jobs already transmitted. 


To obtain a line printer listing of a configuration file, issue 
the following commands (In the order shown): 


:FILE LISTING ;DEV=LP 

:MRJE 

HP 32192A.01.02 MRJE/3000 (C)HEWLETT-PACKARD CO. 1977 
MANAGER CAPABILITY IN EFFECT 

#HOST C This defines Host "C" to be the current host. 
#DISPLAY C 1/43 


Configuration file items are displayed on SSTDLIST also. 


#EXIT 


Examples 


The first example displays the status of a Single job. The con- 
munications link has been established: | 


sMRJE 
HP 32192A.01.02 MRJE/3000 (C)HEWLETT-PACKARD CO. 1977 
MANAGER CAPABILITY IN EFFECT 
#DISPLAY JOB 4 
--JOB#=4 JOBNAME=JOBQA31 USER=MANAGER.SYS, PUB 
PRINT=MGRPR PUNCH=MGRPUN FORMS=MGRFORM 
TRANSMITTED TO HOST WED, OCT 19, 1977, 3:20 PM HOST#=2018 
$DJ2018 DISPLAY COMMAND WILL BE SENT TO HOST 
$15.34.52 JOB 2018 JOBQA31 EXECUTING PRIO 6 


> 


DISPLAY 





This example displays line status for the current host machine: 


#DISPLAY STATUS 
HP IS OFF LINE 
TIME LINE DEACTIVATED=TUE, SEP 20, 1977, 4:38 PM 


This example displays items in the configuration file: 
#DISPLAY CONFIG 6,7 


6. USER HOST COMMAND=SDA 
7. COMMAND CHARACTER=$ 
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NEW 


Creates or re-creates the configuration, job log, and directory 
files for a given host machine. 


NCEW] [Chostid] 





The DSN/MRJE manager must be logged onto MANAGER.SYS in order to 
use this command. 


In a single-host environment, "hostid" need not be specified. In 
a multi-host environment, a host ID should be assigned to each 
host. When a host ID is not assigned to a particular host, that 
host automatically becomes the “default host". Establishing a 
default host in a multi-host environmen may result in users 
erroneously sending jobs to the default host (because they failed 
to specify a host ID prior to using the SUBMIT command). 


Parameters 


hostid Used primarily in multi-host environments. This par- 
ameter can consist of up to eight alphanumeric char- 
acters. If several host machines are defined, each 
hostid must have a unique first character. 


Using NEW 


The first step in DSN/MRJE operation is to create at least one 
set of DSN/MRJE management files for each communication line 
between the HP 3000 and each host. The NEW command is used to 
create these files. 


When “hostid" is omitted from the NEW command, DSN/MRJE assumes 
files are being built for the default host machine. These files 
will be given the names MRJECON, MRJEJOB, and MRJEDIR, to indi- 
cate their association with the default machine. 


If several communications lines are connected at least one set of 
management files must be built for each. Care should be taken to 
avoid using host ID's with identical first characters. DSN/MRJE 
appends the first character of each host ID to MRJECON, MRJEJOB, 
and MRJEDIR to form unique names for each set of files. For 
example, if hostid is PLM2, the files for that host machine will 
be named MRJECONP, MRJEJOBP, and MRJEDIRP. 

















NEW 


When NEW executes, some items in the configuration file are ini- 
tialized with the default values shown in Appendix A. Other 
items are initialized with information provided by the DSN/MRJE 
Manager. 


After entering the NEW command, the Manager will receive’ the 
following prompts: 


MAXIMUM NUMBER OF JOBLOG ENTRIES = 
100 NEW VALUE = 
Enter a value, 25 to 1000. The job log file will be created 


to accommodate the number of specified entries. A carriage 
return retains the 100 value. Note that a large job log file 
increases search time, and therefore response time. On the 


other hand, a small job log file requires frequent purging. 


HOST MACHINE = 
Enter an alphanumeric name up to eight characters in length. 
Tf "hostid" was included in the NEW command, enter that name. 
For the default host machine, enter any name. 


PSEUDO CONSOLE DEVICE = 
Enter the logical device number that was assigned to the 
pseudo console during MPE configuration (Unit 2, driver 
IOMCONSO -- see Appendix D.) 


PSEUDO LINE MONITOR DEVICE = 
Enter the logical device number that was assigned to the first 
line monitor (Unit 0, driver IOMRJEO -- see Appendix D). 


SIGNON CARD IMAGE = 
The format of a signon card is determined by host system per- 
sonnel. Enter the response exactly as they specify. 


HOST SYSTEM = 
Respond HASP, JES2, JES3 or ASP, as appropriate. 


USER HOST COMMAND = 

Users may send one or more host console commands to the cur- 
rent host machine while the line is active. The response to 
this prompt establishes which command(s). For example, if the 
manager enters $D, users will be permitted to enter all host 
console commands that begin with $D; if $DA is entered, users 
will be limited to only that command. Be sure to enter a 
valid response because DSN/MRJE does not check whether the 
entry is a valid one. If the Manager makes a mistake here, 
DSN/MRJE Users will receive an error message when they attempt 
to issue host console commands. 
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PHONE NUMBER IN MRJECONTROL START COMMAND = 
This number appears in a dial message on the HP 3000 terminal 
at which the :MRJECONTROL START command is entered. Unlike the 
previous prompts, a reply here is optional. To not enter a 
phone number, press RETURN. 


Control-Y¥ may be used to terminate the NEW command at any point 
in the dialogue. However, if entered before the phone number 
prompt, no new files are created and all information supplied up 
to that point is lost. 


If the configuration, job log, and directory files for a given 
host machine already exist when this command is used, they will 


be purged and rebuilt. 
NOTE 


This command does not affect files MRJEMSGh, the message 
file, MRJESTRh, the stream file, or MRJECAT, the message 
catalog file. 
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PURGE 


( | Purges entries from a job log file. 


P[URGE] { ofznzoss3 


ACLLJ 





Parameters 


OLDJOBS Purges entries for cancelled jobs and jobs that have 
"“timed-out". Timed-out jobs are jobs that have been in 
in the job log file for a period of time, equal to or 
greater than the time limit configured in item 42 of 
the configuration file. The time limit is measured from 
the point of successful transmission to the host. 





This parameter also causes entries for jobs that were 
transmitted to the host but were not acknowledged as 
having been received to be purged. 


ALL Purges all entries from a job log file. The manager can 
use this parameter only while logged on to MANAGER.SYS. 


Using PURGE 


ALL alters the file directory entry for the current host machine 
to reflect an empty job log file. If entries exist for jobs other 
than OLD JOBS, DSN/MRJE prints the warning message: 





n JOBS ARE IN THE JOBLOG. VERIFY PURGE WITH "YES" 


The purge request must be confirmed with a YES response (Y is not 
<< enough). Any other response causes the PURGE command to _ be 
ignored. 
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PURGE 





Examples 


The first example shows the purging of all jobs, both active and 
inactive. (Note that the HOST command was issued before purging, 
to be sure the command would reference the correct set of files): 


:MRJE 
HP 32192A.01.02 MRJE/3000 (C)HEWLETT-PACKARD CO. 1977 


MANAGER CAPABILITY IN EFFECT 


#HOST PLM2 
PLM2 IS THE CURRENT HOST MACHINE 


#PURGE ALL 
6 JOBS ARE IN THE JOBLOG. VERIFY PURGE WITH "YES" 


YES 
MRJEJOBP COMPLETELY PURGED. 


In the second example, only old jobs are purged: 


#HOST 
DEFAULT HOST ASSUMED 
PIM IS THE CURRENT HOST MACHINE 


#PURGE OLDJOBS 
MRJEJOB 10 JOBLOG ENTRIES CLEARED. 25 FREE ENTRIES NOW EXIST. on 
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Managing DSN/RJE 


a A TYPICAL MANAGER’S SESSION 











In the following example, the DSN/MRJE Manag r builds a_ configu- 
ration file, submits a job, displays the job's status, exits 
DSN/MRJE, and exits MPE. 


:HELLO MANAGER.SYS 
HP3000 / MPE III B.00.00. MON, MAY 8, 1978, 10:40 AM 
:MRJE 

HP 32192A.01.02 MRJE/3000 (C)HEWLETT-PACKARD CO. 1977 
MANAGER CAPABILITY IN EFFECT 

#NEW 

DEFAULT HOST ASSUMED 

MAXIMUM NUMBER OF JOBLOG ENTRIES=100 

NEW VALUE= 

1000 

FOLLOWING MUST BE INITIALIZED IN CONFIGURATION FILE: 
HOST MACHINE= 


MFRM 
PSEUDO CONSOLE DEVICE= 
112 
PSEUDO LINE MONITOR DEVICE= 
110 
SIGNON CARD IMAGE= 
*SIGNON REMOTE31 PASSWORD 
HOST SYSTEM= 
JES2 
USER HOST COMMAND= 
SDA 
PHONE NUMBER IN MRJE CONTROL START COMMAND= 
767-1501 


MFRM FILES CREATED 
#SUBMIT IBMJOB1 
JOB#=1 JOBNAME=RJEDEMO1 RECORDS READ=14 RECORDS WRITTEN=14 
MFRM IS OFF LINE 
#DISPLAY 1 
--JOB#=1 JOBNAME=RJEDEMO1 USER=JIM.DCA,WILLITS 
PRINT="LP" PUNCH="LP" FORMS="LP" 
WAITING TRANSMISSION TO HOST 
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Assume at this point the :MRJECONTROL START command is issued and 
the communications line to the default host (MFRM) is success-— 
fully opened. The Manager displays Job 1 and then exits 
DSN/MRJE as shown below: 





#DISPLAY 1 
-~-JOB#=1 JOBNAME=RJEDEMO1] USER=JIM.DCA,WILLITS 
PRINT="LP" PUNCH="LP" FORMS="LP" 
TRANSMITTED TO HOST MON, MAY 8, 1978, 11:03 AM HOST#=4340 


$DJ4340 HOST DISPLAY COMMAND SENT 
$11.04.30 JOB 4340 RJEDEMOl EXECUTING PRIO 6 
#EXIT 

BYE 


CPU=3. CONNECT=17. MON, MAY 8, 1978 
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HOST CONSOLE COMMANDS 


The DSN/MRJE Manager has access to all host console commands that 
are available at remote host consoles. The DSN/MRJE Manager is 
responsible for determining which of the remote console commands 
to make available to all DSN/MRJE Users. By entering a _ specific 
symbol or symbols in the configuration file, the Manager defines 
which commands the DSN/MRJE User can employ. 


Host console commands: 


@ May be issued interactively while the communications line is 
connected. 


@ May be issued as part of an IBM JCL deck. 


e Must conform to the format and restrictions of the host 
system. 


® Will be refused if any other DSN/MRJE User is currently com- 
municating with the host system. 


Once a DSN/MRJE Manager issues a host console command, that user 
is said to be in “console command mode." Also, that Manager will 
remain in console command mode. In this mode, no DSN/MRJE 
prompts are issued and anything entered is transmitted to the 
host as a console command. When the Manager is in Console 
Command Mode, MRJE will not transmit host console commands that 
are entered by any other user. 


Output from the host console is unpredictable because it is de- 
pendent on host system activity. In most cases, however, a host 
console command generates a response at the Manager's terminal. 
If the terminal falls behind in printing this response, some host 
console output may be lost, unless DSN/MRJE console logging (see 
below) is in operation. 


The Manager may exit console command mode at any time by entering 
Control-Y, which returns the session to DSN/MRJE command mode. 
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HOST CONSOLE COMMANDS 


Example 


In the following example, the MRJE Manager uses the SDA host con- 
sole command (from JES2) to display those jobs that are currently 
at the host. This initiates Console Command Mode. 


#SDA 

$15.33.04 JOB 388 JOBOA31 EXECUTING PRIO 6 
$15.33.04 JOB 390 JOBOA32 EXECUTING PRIO 6 
$15.33.04 JOB 392 JOBOA33 EXECUTING PRIO 6 


CONTROL-Y is entered by the Manager. 
+ 


HOST CONSOLE MESSAGE LOGGING FACILITY 


DSN/MRJE allows for the optional logging of all console messages 
to a specified file. Logging does not interfere with normal con- 
sole operation. 


In order for logging to take place, the DSN/MRJE Manager must 
build or define logging files in PUB.SYS. A separate file must 
be built or defined for each host for which logging is to take 
place. The message file, which is optional, is the destination 
for host console messages. It is named MRJEMSGh (where h is’ the 
first letter of the host identification.) Message files are de- 
scribed in "BUILDING THE DSN/MRJE MANAGEMENT FILES AND OTHER DSN/ 
MRJE FILES" in Section 4, at item 5. 


PERFORMANCE MEASUREMENT 


A limited performance measurement facility is provided through 
the use of the host console message logging facility in the 
MRJEMSGh file. The purpose of this facility is to measure the 
turn around time for host job output rec ived by DSN/MRJE. In 
addition, output from host jobs may be located by searching 
through this file for the following record. 
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re HOST CONSOLE COMMANDS 


A record is written in the MRJEMSGh file for each job received. 
The format of the record is as follows: 


Characters: Description: 
3-6 Job Number 
9-16 Job Name 
22-29 Start receiving time, hh:mm:ss. 
35-42 End receiving time, hh:mm:ss. 
49-54 Total time in seconds. 
61-68 Number of characters received. 
74-80 Number of records received. 





CAUSES AND CONTROL OF UNSOLICITED OUTPUT 


If DSN/MRJE ever receives output from the host that is not 
directed (is unsolicited), it could be because of one of the 
following: 


1) The output has been directed to an unsolicited output device 
through the use of a submit command, for example: 





#SUBMIT TESTJOB; PRINT=0 


2) The host or another remote station has unexpectedly routed 
data to your station. 


3) DSN/MRJE was not able to interpret the print or punch banners 
because they are not “standard” (that is, they do not conform 
to the default configuration file parameters for banners). 
See Section IV, "BUILDING THE DSN/MRJE MANAGEMENT FILES" and 
Appendix A for information on DSN/MRJE recognition of banners. 





4) DSN/MRJE can't read the host console "ON" message because 


a) Items 15-17 in the configuration file weren't configured to 
match the message, or 


b) the host does not send an "ON" message upon receipt of 
jobs. 


5) There was a significant lag between the time the host received 
a job and the time the host returned output to DSN/MRJE. 
During this lag, the contents of the Joblog file (including 
output routing information for your job) were purged. 
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HOST CONSOLE COMMANDS 


6) You have suppressed printing or punching of banners (in your 
JCL or by means of a host console command). 


If the host is waiting to transmit output to DSN/MRJE and you 
know that output will be treated by DSN/MRJE as unsolicited, you 
may still direct it specific destination file. Here are some 
methods for doing this: 


1 a) Raise Outfence on the MPE Spooler, 
b) receive output at the Spooler, and 
c) use the MPE utility SPOOK to "copy" the output data set to 
another disc file, or "output" the data set to tape. 


2 a) Build a large disc file in PUB.SYS for print or punch output 
which could be an MSG file, depending on the type of output 
you expect, and | 

b) specify the name of this file in Items 21-27 (unsolicited 
print disposition) or Items 29-35 (unsolicited punch dispo- 
sition) in the configuration file. 


3a) Define deferred output spool files within the stream file 
MRJESTRh for each configured pseudo printer and punch before 
communication with the host system is initiated. For 
example, if the outfence value is 6 and there is only one 
printer, then include statements such as this 


:FILE UNSLPR1;DEV=LP, 1 
in the stream file; then, 

b) Alter the unsolicited output items of the configuration 
file, items 21-27 for printers and 29-35 for punches, to 
refer to the files defined in step 3a, above. For example, 
alter item 21, unsolicited printer disposition for printer 
1, to the value "!UNSLPRI": then, 


c) Initiate communication with the host system using an 
MRJECONTROL START statement. 
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SECTION 


CONTROL OF THE 
COMMUNICATIONS LINK|| v_| 


This section addresses the DSN/MRJE Console Operator. 


The MRJE Console Operator is able to open and close the MRJE com- 
munications link with the host(s), to change the number of trans- 
mission error retries, to turn on the CS TRACE diagnostic and to 
check the version, update and fix levels of the MRJE software on 
the system. 


Any DSN/MRJE User who has been authorized by the HP 3000 system 
console operator to use the MRJECONTROL commands can carry out 
the DSN/MRJE Console Operator functions. Use is authorized by 
means of the MPE :ALLOW command, as described in "Console 
Operator's Guide" (30090-90013). The format of ALLOW command is: 


sALLOW user.acct ;COMMANDS=MRJECONTROL 


The :MRJECONTROL commands are summarized in Table 5-1. 


Control of the Communications Link 


Table 5-1. MRJECONTROL Commands 





COMMAND SYNTAX AND FUNCTION 






:MRJECONTROL START [,hostid] [;trace function] 









Used to open a communications link, initiate 
transmission over the link, turn on the CS TRACE 
facility. 








sMRJECONTROL SIGNOFF [,hostid] 





Used to close the communications link in an 
orderly fashion, with a "SIGNOFF". 






:MRJECONTROL KILL [,hostid] 







Used to close communications link immediately 
and in an unorderly fashion, without "SIGNOFF". 






sMRJECONTROL RETRIES, [Lhostid], retrynum 







Used to set a limit on the number of times 
DSN/MRJE will request re-transmission of block 
of data not received successfully from host. 





sMRJECONTROL TRACE, [Lhostid], ON [trace options] 
TRACE, [Lhostid], OFF 








Used to activate the CS communications Link 
trace facility. 








sMRJECONTROL CHECK 





Used to check the version, update and fix levels 
of the MRJE software currently on your system. 





















MRJECONTROL START 


Use the:MRJECONTROL START command to open the communication line 
to a host and to initiate transmission over the line. The CS 
TRACE diagnostic may also be activated at this time. (For more 
information on CS TRACE, see "MRJECONTROL TRACE", in this 
section.) The syntax of the START command is 


s:MRJECONTROL START [,hostid] [;trace function] 





where 
START Requests connection to default host machine. 


START, hostid Requests connection to machine identified by 


“hostid". 
trace function TRACE, ON [trace options] 
TRACE, OFF See “MRJECONTROL 
TRACE" in this 
trace options [,CALLJC, (mask](,Cnumentries] section. 


{, LWRAPJ](L,filename]]]]] 


Contact Hewlett-Packard to find out the most appropriate way to 
use the trace function. 


Prior to issuing an MRJECONTROL START check to see if the stream 
file exists for the host identification to be started. The 
stream file is named MRJESTRh, where "h" is the host identifica- 
tion character. This is because an MRJECONTROL START command 
causes a corresponding MRJESTRh file to be streamed. Each host 
identification has its own stream file. 


MRJECONTROL START 


This is how to create such a stream file for a default host: 


>HELLO MANAGER.SYS 
HP3000 / MPE IV C.S2.08. WED, FEB 3, 1982, 2:56 PM 


: EDITOR 

HP32201A.7.10 EDIT/3000 WED, FEB 3, 1982, 2:56 PM 

(C) HEWLETT-PACKARD CO. 1981 

/aq 

! JOB MANAGER .SYS ;HIPRI ; RESTART; TIME=? 

! COMMENT THIS JOB WILL ALLOW USERS TO ROUTE OUTPUT TO 
{ COMMENT AN HP2680 WITH A SPECIFIC ENVIRONMENT. 

{ COMMENT ALSO, THE STACK DUMP FACILITY IS ARMED TO 
{ COMMENT OPERATE WHEN AN MRJEMON PROBLEM OCCURS. 
IFILE ELITE;DEV=LPS ;ENV=ELITE.ENV2680A. SYS 

!FILE HOLDLP;DEV=LP,1 

!SETDUMP DB,ST 

!RUN MRJEMON;INFO=" " 

1EOJ 


/keep mrjestr 
fexit 





Access to stream files like the one above should be limited to 
their creator by using the MPE command ALTSEC, as described in 
the "MPE Commands Reference Manual" (30000-90009). 


If communications are on a private (leased) line, or a on 
switched line with an auto-dial capability, connection occurs 
shortly after the START command is issued, and the a message is 
received at the HP 3000 master console like the following: 


10:51/24/MRJE: SIGNON COMPLETED 
If the communication link is a switched line without auto dial- 
ing, a message similar to the following will be printed at the 
master terminal after MRJECONTROL START is issued: 
10:50/24/MRJE:DIAL REMOTE 767-1501 


The telephone number printed in this message is item 39 of the 
configuration file. 


If the START command includes hostid, the first character of the 
hostid is appended to MRJE. For example, if the host ID is 
BRUNO, the START command will look like this: 


:MRJECONTROL START,B 


July 1983 5-4 


























MRJECONTROL START 


and the console message for switched lines without autodialing 
will be similar to this: 


10:50/24/MRJEB:DIAL REMOTE 767-1501 


Following display of this console message, the DSN/MRJE Console 
Operator should: 


1) Place the call at the dial-up modem. 
2) Listen for the answer tone. 


3) Press the DATA button, if the modem so requires, when the 
answer tone becomes audible. 


4) Check the system console terminal for a message similar to 
the following: 


10:51/24/MRJE: SIGNON COMPLETED 


5) If the readers, printers, and punches for your remote station 
have been drained on the host, start the ones you will be 
need with host system console commands. 


Once the communications link has been established: 


@ DSN/MRJE will automatically transmit jobs to the host and 
route output from the host to the designated HP 3000 output 
files. 


e DSN/MRJE Users, working at their terminals, will be able to 
transmit host console commands and receive responses from the 
host. 


@ The DSN/MRJE Manager, if working at a terminal, will be able 
to monitor host system activity. 


@ The DSN/MRJE Console Operator if working at a terminal will be 
able to monitor for DSN/MRJE messages. 


Each time the :MRJECONTROL START command is issued, MRJE checks 
whether the correct MRJE modules are installed. If revision 
levels do not match among modules, the following message is 
issued: 


INCOMPATIBLE MRJE MODULES 


The :MRJECONTROL CHECK command should then be entered to identify 
the incorrect module. 


MRJECONTROL SIGNOFF 


Close a communications link in a systematic fashion with 


sMRJECONTROL SIGNOFF [,hostid] 





where 

SIGNOFF Initiates systematic closing of line to de- 
fault host. 

SIGNOFF, hostid Initiates systematic closing of line to host 


identified by “hostid". 


After the command has been issued, HP systems may print the 
following (whether they do or not depends on the host system 
configuration): 


CS WARNING 103 

or 
CS WARNING 207 

or 
MRJE TERMINATING 


Although the message can normally be ignored, the DSN/MRJE Man- 
ager may occasionally ask for the warning number. 


HP systems communicating with JES2 work stations print: 
MRJE TERMINATING 


When the :MRJECONTROL SIGNOFF command is entered, any currently 
active readers finish transmitting before the command takes 
effect. 


If the :MRJECONTROL SIGNOFF command is issued while a file is 
being transmitted to or from the host, transmission will continue 
until all of the file has been sent. Then the line will be dis- 
connected. In this way no data will be lost. 

















MRJECONTROL KILL 


Occasionally, an emergency may occur, a SIGNOFF command may fail 
to produce the "MRJE TERMINATING" message, or a dial-up line may 
be busy--making it necessary to terminate the subsystem abnor- 
mally with the KILL command. The syntax of the command is 


sMRJECONTROL KILL [,hostid] 





Where 


KILL Causes all communication with the default host to 
halt immediately. 


KILL,hostid Causes all communication with the host named _ by 
"hostid" to cease immediately. 


The command :MRJECONTROL KILL should be used in emergencies only, 
because error free recovery from the command is not certain. 


Following a KILL command, it may be necessary to enter the 
sMRJECONTROL START command several times. If repeated attempts to 
make the connection fail, consultation with the host system 
Operator may be required. 


MRJECONTROL RETRIES 


It is possible to regulate the number of times DSN/MRJE will 
repeat its attempt to receive a block of data from the host when 
transmission errors are occurring (perhaps because of a "dirty" 
communications line). This is done by issuing the command 
:MRJECONTROL RETRIES. The command has the syntax 


sMRJECONTROL RETRIES, [Lhostid], retrynum 





where 

hostid Is the name by which the host is identified. If 
this parameter is not used, DSN/MRJE assumes’ the 
default host is intended. 

retrynum Is an integer between 1 and 255, inclusive. 


This command may be issued anytime the line is active. 


Since this command adjusts a communications driver retry 
counter, its use could affect processing speed and sys- 
tem performance. 























MRJECONTROL TRACE 


The CS TRACE facility can be enabled via the :MRJECONTROL ‘TRACE 
command (or via :MRJECONTROL START--see above). Contact Hewlett— 
Packard to find out the most appropriate way to use this command. 
This command can be entered any time the line is open. The 
command has the syntax 


s:MRJECONTROL TRACE, [hostid], ON [trace options] 


TRACE, [Lhostid], OFF 





where 

hostid Is the name by which the host is identified. If 
this parameter is omitted, DSN/MRJE will assume 
the default host is intended. 

trace options Has the format [,[ALL][,{mask][,numentries] 

[, (WRAP]({,Cfilename]J]Jj] 

ALL Generates a record of all transmission activity. 
When omitted, trace records are written only 
when transmission errors occur. 

mask Is an octal number preceded by a percent symbol 


that specifies the type of events to trace. The 
default mask is %37. 


Mask bit settings are defined as follows: 


used for DSN/MRJE) 
used for DSN/MRJE) 
entries (default=OFF) 


and PEDT entries (default=ON) 
entries (default=ON) 
entries (default=0ON) 
PSCT, PPOL, PSEL entries (default=0ON) 
PSTX entries (default=ON) 





NOTE 


INP interconnect entries should not be traced, except at 
Hewlett-Packard's request. This is because many entries 
are generated. 


MRJECONTROL TRACE 


numentries Is the number of entries per record. (Default is 
24. Maximum is 248.) For an INP use 24. 


WRAP Causes trace entries that overflow the trace 
record (that exceed numentries) to overlay the 
first entries written to that record. If omit- 
ted, the overflow entries are discarded. 


This parameter is applied to entries within 
records, not records within files. If trace 
records overflow a trace file, CS TRACE auto- 
matically starts writing them over the first 
records in the file. 


filename Is the name of the file where the trace records 
are to be stored. If this parameter is omitted, 
CS TRACE creates a file in PUB.SYS with the name 
MRJETRCh, where "h" is the first character of 
the host ID. If a file other than MRJETRCh is 
to be used, it must be built before executing 
sMRJECONTROL TRACE. 


Listing Trace File Contents 


The CS TRACE dump utility program CSDUMP.PUB.SYS can be used to 
format and print the contents of trace files generated by the 
trace facility. An example of the commands required to list the 
files to a line printer is: 


:FILE CSTRACE=filename 
:FILE LIST;DEV=LP ("LP", or other designation for "printer") 
:RUN CSDUMP. PUB.SYS[,HEX] 


where "filename" is the name of the file specified in the 
sMRJECONTROL TRACE command; or if no file name was specified, 
"filename" is MRJETRC[Lh], and "h" is the host identification. 
The secondary entry point "HEX" in CSDUMP.PUB.SYS allows raw data 
to be output in hexadecimal. 


Contact Hewlett-Packard for assistance in interpreting trace file 
contents. 





a, 








MRJECONTROL CHECK 


The :MRJECONTROL CHECK command can be used to check the version, 
update and fix levels of each MRJE module. This can be particu- 
larly useful in verifying the correct installation of MRJE. The 
syntax of the command is 


sMRJECONTROL CHECK 





When the command is issued, a table showing each MRJE module and 
its levels of revision is printed at the user's terminal. The 
format of the table is as follows: 


MODULE VERSION 
(REVISION) 

MRJEMISC1/2 V.UU.FF 
MRJE V.UU.FF 
MRJEMON V.UU.FF 
MRJEOUT V.UU.FF 
MRJELOGR | V.UU.FF 
TOMPNLPO V.UU.FF 
TOMCONSO V.UU.FF 
TOMRDRO V.UU.FF 
IOMRJEO V.UU.FF 
IOMRJE1 V.UU.FF 


"Vv" stands for "version", “UU" for "update", and "FF" for "fix". 


If a module is not present in the system, the following message 
is printed in place of V.UU.FF: 


*UNABLE TO ACCESS MODULE* 


If a module is present but no revision levels can be determined, 
the following message is printed in place of V.UU.FF: 


*NO VERSION LEVEL* 
Each time the MRJECONTROL START command is issued, MRJE checks 
whether the correct MRJE modules are installed. If revision 
levels do not match between modules, the following message is 
issued: 


INCOMPATIBLE MRJE MODULES 


The MRJECONTROL CHECK command should then be issued to identify 
the incorrect module. 






























DSN/MRJE ERROR CONDITION AND 
INFORMATION MESSAGES | vi_| 





COMMAND ERRORS 


DSN/MRJE command errors fall into four general categories: 


e Syntax errors -- These include invalid commands as well as 
commands in improper format. 


@ Inaccessible files -- A job is refused if any file named in 
the SUBMIT command cannot be opened. A command is refused if 
it contains the name of a nonexistent job log or configuration 
file. 


e Invalid user ID -- A command is’ refused if a DSN/MRJE User 


attempts to cancel or display a job that does not belong to 
him or her. 


@ Full job log file -- If a DSN/MRJE User attempts to submit a 
job and the job log file is full, the SUBMIT command is 
refused. The DSN/MRJE Manager can make space in the file by 
purging old jobs or by purging all jobs. 


In each of the above cases, DSN/MRJE sends an appropriate message 
to the user's output device. 


SYSTEM FAILURES 
Operating failures fall into two categories: 
e local failure -- HP 3000 hardware or software failure. 


@e Remote failure -- Host system or communication line failure. 


Local Failures 


After an HP 3000 failure, jobs that were submitted to the MPE 
spooler and jobs that the spooler was actively writing to the 
host card reader are recovered if the system is restarted with a 
WARMSTART; however, any purged extents are lost. Jobs that were 
being submitted to a non-spooled host card reader are lost and 
must be resubmitted. 


Line printer and punch output being received by the HP 3000 when 
a failure occurs is recovered during a WARMSTART. Output re- 
ceived by a non-shareable device before the failure is_ saved 
whether the device was spooled or non-spooled. Output in the 
process of being written to a disc file may be lost. 
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After a failure and subsequent restart, the DISPLAY command 
should be used to determine the status of suspect files and jobs. 
For example: 


e A User submits a job but does not receive a ‘job number or 
error message. To see whether the job has been submitted, the 
User should enter: 


DISPLAY J, jobname 


e A User cancels a ‘job but does not receive a "JOB CANCELED" 
message or an error message. To check if the job was 
canceled, the User should enter: 


DISPLAY J, job# 
It may be desirable to check host system output queues. 


e If the DSN/MRJE Manager is using the ALTER command to change 
the configuration file and does not receive a response after 
entering a new value, he or she should verify that the file 
has been updated by entering: 


DISPLAY C,item# 


In most cases, an interrupted command must be re-entered. This 
is also true for a host console command if the host hasn't 
responded yet. 


If the HP 3000 fails while the line to a host is open, the line 
will automatically be closed. After system restart, it will be 
necessary to issue the :MRJECONTROL START command again to re- 
open the line. 


Remote Failures 


Following a host system or communication line failure, DSN/MRJE 
automatically terminates the connection in an orderly manner. It 
sends a termination message to the HP 3000 system console, enters 
the termination time in the configuration file, and shuts down 
any spooled host card readers it is controlling. Spooled files 
are deferred. 


After the host system has been restarted or the line problems 
solved, the Console Operator must issue the :MRJECONTROL START 
command to restart the subsytem. At the same time the Console 
Operator should assign the deferred spool files a higher 
priority. 








) 














Error Conditions 


After a failure, any jobs shown by the DISPLAY command to have 
been transmitted may not be necessarily completely transmitted. 
For this reason, it may be necessary to do a host console display 
command after the line is re-established to determine which jobs 
are on the host system. 


DSN/MRJE MESSAGES 


These types of messages relate to DSN/MRJE activity: 


@ User messages ~-- These are printed on a user's output device. 
They are listed alphabetically in Table 6-1. 


@ MRJECONTROL distributed console messages -- These are sent to 
the terminal of the user who issued the MRJECONTROL command 
that triggered the message. These messages are listed in Table 
6-2 in numerical order (by Command Interpreter Error--CIERR- 
number). 


@ Console Operator messages -~- These are sent to the system con- 
sole. They are listed alphabetically in Table 6-3. 


In these three tables, messages that report an error or failure 
also include the cause and instructions for corrective action. 
In cases where a message only imparts information (no error or 
failure occurred), only the message and its meaning are given. 


CS ERRORS 


Occasionally failures causing irrecoverable errors occur on a 
communication link. These CS I/O errors are reported on the sys- 
tem console by code number. The error codes are included within 
relevant error messages. 


Table 6-4 contains the CS Irrecoverable Error codes, while Table 
6-5 contains the CS Recoverable Error codes. An error is 
"irrecoverable" when the system is unable to recover from the 
error without human intervention. The system can recover from a 
Recoverable Error and no action is required by the user; a 
Recoverable Error code may follow an Irrecoverable Error code, 
thus informing the user that both types of errors have occurred. 
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Table 6-1. DSN/MRJE User Messages 






* "ALL" OR "OLDJOBS" ARE ONLY VALID PURGE PARAMETERS. 
A PURGE parameter other’ than ALL or OLDJOBS was 
entered. Re-enter PURGE command with no parameter 
(for OLDJOBS) or with "ALL" or "OLDJOBS". 








* "BS" OR "CS" OR "Ds" REQUIRED. 
BS, CS, or DS are the only valid values for output 
process priority in the configuration file. 








jJobname CANCELED. 
job# 






Specified job has been canceled as requested. 






* jobname CAN'T BE CANCELED. 
job# 







Named job cannot be canceled because Of an error in 
writing to or reading from a job log file. Retry the 
CANCEL. 









SCJ host#,host# CANCEL COMMAND WILL BE SENT TO HOST. 

SCJ host#,P 
When an interactive User/Manager cancels a job which 
has been transmitted to the host and the host is 
on-line, DSN/MRJE automatically sends the appropriate 
host cancel command and prints the host response. 









* COMMA OR NUMBER REQUIRED. 
Comma or number is required. 






* COMMA OR SLASH REQUIRED TO SEPARATE PARAMETERS. 
Comma or slash required to separate parameters in 
“joblist" or “itemlist". 






* COMMA REQUIRED TO SEPARATE PARAMETERS. 
Comma is required to separate positional parameters, 
DAYS, HOURS, MINUTES. 









NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DEFAULT HOST CONFIGURATION FILE SET CANNOT BE ACCESSED. 
HOST hostname 


Named host configuration file cannot be accessed be- 
cause of an open or read error. Determine the reason 
for the I/O failure from the MPE file error number. 


CONTINUATION LINE EXPECTED. 





When an ampersand (&) is entered at the end of a_ line 
in a SUBMIT command, DSN/MRJE expects the following 
line(s) to be a continuation of the command. Re-enter 
the entire SUBMIT command with continuation line(s) as 
required. 


CONTROL-Y IS THE ONLY VALID INPUT DURING HOST COMMAND 
PROCESSING. 


A User may only enter Control-Y during host console 
command processing. (Control-Y halts output.) Any 
other input causes this error message and returns’ the 
# prompt. If all output has not been received, re- 
enter the host console command. 


filename RECORD m CTRANSLATE FAILED. 








An error occurred while translating a SUBMIT input 
file from ASCII to EBCDIC (or EBCDIK, depending on the 
translation type). This is an internal software 
failure. Contact Hewlett-Packard. 


HOURS, MINS CAN'T BE ZERO. 
The maximum time a job remains in the job log file 
after transmission cannot be zero. 


DEFAULT HOST ASSUMED. 


If no host name is given in a HOST or NEW command, 
DSN/MRJE assumes the default host is desired. 


* DIGIT OR SPECIAL CHARACTER REQUIRED. 


Host system character must be a digit or ae special 
character. Re-enter command. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 









* n DIGITS ARE THE MAX ALLOWED FOR THIS NUMBER. 
_A number with too many digits has been entered. Re- 
enter command with no more than n digits. 








SDJ host# DISPLAY COMMAND WILL BE SENT TO HOST. 
When an interactive User/Manager displays a job that 
has been transmitted to the host and the host is on- 
line, DSN/MRJE automatically sends the appropriate 
host display command and prints the host response. 








jobname: DUPLICATE JOBNAMES IN JOBLOG. CANCEL REFUSED. A 
DISPLAY OF JOBS WITH THIS NAME WHICH YOU OWN (IF ANY) 








FOLLOWS: 
A CANCEL by job name is refused if duplicate names 
exist in the job log file. Re-enter the CANCEL 






command, specifying “job#" rather than “jobname". 






* “EBCDIC" OR "EBCDIK" REQUIRED. 
EBCDIC and EBCDIK are the Only valid translation 
types. Re-enter. 










EMBEDDED BLANKS NOT ALLOWED IN QUALIFIED NAME. 
A qualified actual file designator may not contain 
embedded blanks. Re-enter. 








* END OF FILE ON SSTDINX. FURTHER INPUT IMPOSSIBLE. FATAL, 
ERROR! 
End-of-file on standard input device (for example, a 
user enters ":EOD" while submitting from SSTDINX) 
makes further input impossible. MRJE terminates. Run 
the job again and do not use ":EOD" or "sEOF" in 
SUBMIT. Use “MRJEOD". 















NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


ENTER INPUT ENDING WITH "MRJEOD". 





This message followed by a prompt (>) requests input 


from SSTDIN/SSTDINX during SUBMIT. If S$STDIN or 
SSTDINX are FD files, any comment on the ##FD_ card 
will appear ahead of this message. For example, 


assume infile DATA1 contains the record 
##FD SSTDIN This input is for file DATAI. 


When this ##FD card is read by DSN/MRJE, the following 
appears on the terminal: 


This input is for file DATAI1. 
ENTER INPUT ENDING WITH "MRJEOD" 
> 


* EXTRANEOUS INFORMATION AFTER VALID ITEM. 


Some extra information has been included that DSN/MRJE 
does not recognize. Re-enter with only the required 
information. 


* ##FD CARDS NOT PERMITTED IN LEVEL 2 FILE. 





File Definition cards may be contained only in an 
Infile (level 0) or a first-level FD file. Remove the 
##FD card from the named level 2 file, reconstruct 
input files as required, and re-submit job(s). 


FILE ERROR #n, filename CAN'T BE CLOSED. 





Named SUBMIT file (input or output) cannot be closed. 
SUBMIT processing continues. Determine the reason for 
the failure from MPE file system error number (#n). 


* FILE ERROR #n, filename CAN'T BE CLOSED. FATAL ERROR! 


Named file (configuration, directory, job log, or host 
console device) cannot be closed. DSN/MRJE termina- 
ted. Determine the reason for the failure from MPE 
file system error number (#n). : 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


* FILE ERROR #n, filename CAN'T BE OPENED. 
Named file cannot be opened. Determine the reason for 
the failure from MPE file system error number (#n). 


* FILE ERROR #n, filename CAN'T BE OPENED. FATAL ERROR! 
Named list file (if other than S$STDLIST) cannot be 
opened. DSN/MRJE terminated. Determine the reason for 
the failure from MPE file system error number (#n). 


* FILE ERROR #n, MRJEJOBh RECORD m CAN'T BE POSTED. 
Record m of job log MRJEJOBh cannot be physically 
transferred from the I/O buffer to the disc file. 
Determine the reason for the I/O failure from MPE file 
system error number (#n). a“ 


* FILE ERROR #n xxxx CAN'T BE READ. 
xxxx = "filename RECORD m", "HOST CONSOLE OUTPUT", or 
“STANDARD INPUT FILE". Determine the reason for I/O 
failure from MPE file system error number (#n). 


* FILE ERROR #n, filename RECORD m CAN'T BE WRITTEN. 
Record m of the named file cannot be written. Deter- 
mine the reason for the I/O failure from the MPE file - 
system error number (#n). a 


* FILE ERROR #n, filename RECORD m CAN'T BE WRITTEN. FATAL 
ERROR! 
An output record cannot be written to the named list 
File. DSN/MRJE terminated. Determine the reason for 
the I/O failure from the MPE file system error number 
(#n). 


* FILE ERROR #¢n, xxxx CAN'T BE WRITTEN TO HOST READER. 
Xxxx = "filename RECORD m" or "MONITOR CARD". Record 
“m" of the SUBMIT input file, or the monitor card can-— 
not be written to the host reader. (The latter asso- 
ciates a host job with a pseudo reader.) Determine the 
reason for the I/O failure from the MPE file system 
error number (#n). 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


* FILE ERROR #n, CAN'T CLOSE $STDINX. HOST CONSOLE COMMANDS 











CAN'T BE SENT. 
SSTDINX (standard input device) must be closed, then 
re-opened for NOWAIT I/O, in order to send host con- 
sole commands. Determine the reason for the the 
failure from the MPE file system error number (#n). 


FILE ERROR #n, HOST BUSY. CONSOLE COMMAND NOT SENT. 
Host pseudo console device has received more messages 
from the host than it can handle. Determine the reason 
for the failure from the MPE file sytem error (#n). 


FILE ERROR #¢n, HOST CONSOLE CAN'T BE OPENED. 
Host pseudo console device specified in the configura- 
tion file cannot be opened. Determine the reason for 
the failure from MPE file system error number (#n). 


FILE ERROR #¢n, HOST CONSOLE COMMAND CAN'T BE WRITTEN. 
Host console command cannot be written to the host 
pseudo console device specified in the configuration 
file. Determine the reason for the I/O failure from 
the MPE file system error number (#n). 


FILE NAME, DEVICE CLASS, OR LOGICAL DEVICE NUMBER REQUIRED. 
File name, device class, or logical device number is 
the only valid input. Re-enter. 


hostname FILES CREATED. , 
The configuration file set for the named host has been 
created as requested in the NEW command. 


FOLLOWING MUST BE INITIALIZED IN CONFIGURATION FILE: 
When creating a new configuration file, certain items 
that do not have default values must be initialized. 


FORMS SPECIFIED TWICE. 
"FORMS" file specified twice in SUBMIT command. Re- 
enter SUBMIT command, specifying FORMS only once. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


* GET PRIVILEGED MODE FAILURE. FATAL ERROR! 


An error occurred in the GETPRIVMODE intrinsic. This 
is an internal software failure. Contact Hewlett— 
Packard. 


* GET USER MODE FAILURE. FATAL ERROR! 


An error occurred in the GETUSERMODE intrinsic. This 
is an internal software failure. Contact Hewlett- 
Packard. 


* HOSTNAME MUST START WITH SAME CHAR AS HOSTID 


The first character of a host name must be the same as 
the first character of the host ID given in the NEW 
command. Re-enter. 


* jobname IN DIRECTORY (ENTRY n) BUT NOT IN JOB Loc. FATAL 


ERROR! 


Named job has been found-in directory entry n, but 
cannot be found in the job log. DSN/MRJE terminated. 


This is an internal software failure. Do not permit 
further jobs to be submitted to this job log. When 
all jobs in it have completed, use FCOPY to list the 
directory and job log as follows: 


sFILE L;DEV=LP 

:RUN FCOPY 

>F ROM=MRJEJOBh ; TO=*L ;OCTAL;CHAR 
>F ROM=MRJEDIRh ;TO=*L s;OCTAL;:CHAR 
>EXIT 


("h" is the host ID.) 
Show the listing to Hewlett-Packard. Use the PURGE ALL 


command to re-initialize the directory and job log 
files. 


* INPUT FILE NAME(S) REQUIRED. 


SUBMIT requires at least one input filename. Re-enter 


the command. 
NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


* INPUT MUST BE NUMERIC 
Numeric input required. Re-enter. 


INTERACTIVE TERMINAL REQUIRED FOR HOST CONSOLE COMMANDS. 
User/Manager must run DSN/MRJE interactively in order 
to send host console commands from ae terminal. 
(Console commands may also be sent as part of an IBM 
JCL deck, but they must be in batch format.) 


* INVALID ACTUAL FILE DESIGNATOR. 
A fully qualified actual file designator has the form 


filename/lockword.groupname.accountname 


o where names and lockword have a maximum of eight 
alphanumeric characters each, and the first character 
is alphabetic. No embedded blanks are permitted. 
Re-enter. 


* INVALID COMMAND. 
MRJE does not recognize the input as a command. Enter 
a valid MRJE or host Job Entry Subsystem command. 





‘ * INVALID DEVICE CLASS SPECIFICATION. 
Valid device class has the form “name", where name can 
have a maximum of eight alphanumeric’ characters, 
starting with an alphabetic. No embedded blanks are 
permitted and quotation marks are required. Re-enter. 


* INVALID FILE EQUATION SPECIFICATION 
Name must be less than or equal to seven characters. 
Consult your system administrator for more details. 





* INVALID HOST SYSTEM. 
HASP, JES2, JES3, and ASP are the only valid host Job 
Entry Subsystems. Re-enter. 


* INVALID HOSTID. MUST BE ALPHANUMERIC, <=8 CHARS. 
| Valid host ID has a maximum of eight alphanumeric 
characters. Re-enter. 


NOTE 


An asterisk (*) preceding a message indicates the error 
Causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


* INVALID JOBNAME-~-TOO LONG. 
Eight characters is the maximum length for host job 
name. Re-enter. 


* INVALID KEYWORD. 
Valid keywords are READER, PRINT, PUNCH, FORMS. Re- 
enter SUBMIT command. 


* INVALID OCTAL NUMBER. 
Octal number cannot contain blanks or the digits 8 and 
9. Re-enter. 


* INVALID PARAMETER FOR DISPLAY COMMAND. 
Valid DISPLAY parameters are CLONFIGURATION], a, 
DCIRECTORY], H[OST], J[OBLOG], O[LDJOBS], S[TATUS]. 
Re-enter DISPLAY command with correct parameter. 


* INVALID SPECIAL CHARACTER. 
Re-enter using one of the following special characters 





only: 
/ S$ #t#e@/ae"()> Bp saRle*eea' 
* INVALID SUBMIT PARAMETER. 
Valid SUBMIT parameters are "“infile" "(N)"  "(N,T)" 
"(T,N)" "(T)" and the keywords "READER", "PRINT", 


"PUNCH", and "FORMS". Reenter SUBMIT command. 


* device IS AN INVALID PSEUDO LINE MONITOR DEVICE. FATAL 
ERROR! 

DSN/MRJE, in determining whether the host is on-line 
or off-line, has found that the pseudo line monitor 
logical device number in the configuration file is 
invalid. Ensure that the logical device number in the 
configuration file correctly indicates the pseudo line 
monitor device configured on the 3000. 





* jobname IS NOT YOUR JOB. 
Requested job will not be canceled or displayed be- 
cause the user's logon ID does not match that in the 
job log file entry. Re-enter CANCEL or DISPLAY with 
correct job name or job number. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- lite, 
interactively. | 
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Table 6-1. DSN/MRJE User Messages (continued) 


hostname IS OFF-LINE. 
Named host is off—line. 


hostname IS OFF-LINE. HOST CONSOLE COMMAND CAN'T BE SENT. 
Host console command cannot be sent because named host 
is off-line. Re-enter command when host is on-line. 


hostname IS OFF-LINE. JOB CAN'T BE CANCELED AT HOST. 
Job to be canceled has been transmitted to host, but 
the host is now off-line, so a CANCEL command cannot 
be sent to host. However, the cancel flag in the job 
log entry is set so that any output from the job will 
be flushed. 


hostname IS ON-LINE. 
Named host is on-line. 


hostname IS THE CURRENT HOST MACHINE 
Named host is the host to which all succeeding 
commands will be directed. 


n IS THE MAX LEVEL OF NAMES IN THIS ACTUAL FILE DESIGNATOR. 
Lockword, groupname, and accountname are the only per- 
missible file name qualifications. 


n IS THE MAXIMUM NUMBER OF CHARACTERS FOR THIS PARAMETER. 
Certain inputs, such as phone number in the configura- 
tion file, cannot exceed a specified length. Reenter. 


command IS THE ONLY VALID CONSOLE COMMAND. 
The User is permitted to use only the host console 
command(s) designated by the Manager in the configura- 
tion file in Item 6. Re-enter. 


m TO n IS THE VALID RANGE FOR THIS PARAMETER. 
The number specified is not within valid range. 
Re-enter. 


ITEM 4 ONLY DISPLAYED FOR MANAGER. 
Item 4 in the configuration file (host SIGNON image) 
is displayed only for the MRJE Manager. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


ITEM NOT USED WITH THIS HOST SYSTEM. 
Items ll and 17 in a configuration file are not used 
with a JES3 or ASP host. 


* ITEM NUMBER REQUIRED. 
When altering a configuration file, item number is 
required. Re-enter with an item number. 


JOB ALREADY CANCELED. 
A CANCEL request has been entered for a job which has 
already been canceled. The job log entry is 
displayed. 


CAN'T BE CANCELED DUE TO A PREVIOUS SYSTEM FAILURE. 

Message occurs if the system is restarted between the 
time a job is submitted and the time a CANCEL request 
is issued. System restart invalidates the spool file 


numbers that would normally be used in a cancelation 
procedure. Thus the CANCEL request fails. After re- 
ceiving all output for all jobs, purge all old jobs. 


* JOB CAN'T BE CANCELED AT HOST FOR NON-INTERACTIVE USER. 
Job to be canceled has been transmitted to the host, 
but since the User/Manager is not running DSN/MRJE 
interactively the CANCEL command cannot be sent to the 
host. However, the cancel flag in the job log entry 
is set so that any output from the job will be 
discarded. 


JOB NOT CANCELED. 
When User/Manager requests that a job be canceled, the 
job log entry is displayed. In an interactive session 
DSN/MRJE then asks for verification of the CANCEL. I£ 
the response is anything other than "YES", the job is 


not canceled. 
NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


n JOBS ARE IN THE JOBLOG. VERIFY PURGE WITH "YES". 
When the Manager enters the PURGE ALL command DSN/MRJE 
checks to see whether there are any jobs in the job 
log. (These may or may not have completed.) If there 
are remaining jobs and if the Manager is running 
interactively he or she is asked to verify the PURGE 
request by typing YES. 


JOB#n NO JOBLOG ENTRY. 
No job log entry exists for the job specified in a 
CANCEL or DISPLAY command. Display by job name to 
determine the correct job number. 


LOGICAL DEVICE NUMBER OR DEVICE CLASS REQUIRED. 
A logical device number or device class is the only 
valid input. Back-references not permitted. 


Re-enter. 


MANAGER CAPABILITY IN EFFECT. 
This user has "OP" capability. 


MANAGER CAPABILITY REQUIRED FOR THIS COMMAND 
This command is not available to a user without "op" 
capability. 


MAXIMUM OF 5 INPUT FILES ALLOWED. 
SUBMIT will accept a maximum of five explicit input 
files. Re-enter the SUBMIT command. 


MISSING RIGHT PARENTHESIS. 
Closing right parenthesis has been omitted from the 
"(NOTRANSLATE) " or "(TRANS PARENT ) " parameter. 
Re-enter the SUBMIT command. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


MRJECONh FILE ALREADY EXISTS. REPLY "YES" TO.RECREATE. 
The host named in NEW command already has ae set of 
configuration files. In an interactive session the 
Manager is asked to verify that the existing files are 
to be deleted and new ones created. Reply YES to 
delete the existing set of configuration files. Any 
other response will retain the existing files. 


MRJECONhH NOT ALTERED. 
No change has been made to the named configuration 
file because of an I/O error, invalid input, or no new 
value being entered when requested. If a change is 
required, re-enter the ALTER command. 


MRJECONh SUCCESSFULLY ALTERED. } 
The named configuration file has been successfully 
altered as requested. 


MRJEJOBh COMPLETELY PURGED OF ALL JOB ENTRIES. 
Named job log has been completely purged as requested. 


* MRJEJOBh DIRECTORY FULL. NO FURTHER JOBS CAN BE 
SUBMITTED. 
Directory of the named job log indicates that the job 
log is full. PURGE the named job log of old, inactive 
jobs. 





* MRJEJOBh DIRECTORY/JOBLOG UPDATE CAN'T BE COMPLETED. 
FATAL ERROR! 
Some or all entries have been deleted from the job log 
during PURGE, but the job log or directory cannot be 
updated because of an I/O error. DSN/MRJE terminated. 
Rebuild the set of configuration files for this host 
using the NEW command. 





MRJEJOBh END OF FILE. 
End-of-file has been reached in search of named job 
log. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


MRJEJOBh n JOBLOG ENTRIES CLEARED. m FREE ENTRIES NOW 
EXIST. 
A PURGE command cleared n entries from the named job 
log file by: 
@ deleting canceled jobs 
@® deleting timed-out jobs 
@® clearing directory entries that were reserved for 
jobs that failed during SUBMIT. 


MRJEJOBh JOBLOG IS EMPTY. 


Named job log is empty. This response may be given to 
a DISPLAY DIRECTORY, DISPLAY JOBLOG, or PURGE command. 


MRJEJOB[x] NOT PURGED. 
The named job log has not been purged because the Man- 
ager negated his or her request, or an I/O error 
occurred. If PURGE is required, determine the reason 
for failure from the MPE file error number given in 
the I/O error message and re-enter the PURGE command. 


MRJEJOBh n OLD JOBS IN THIS FILE. 
The named job log contains n "old jobs" -- jobs which 
have timed-out or been canceled and are therefore sub- 
ject to purging. 


MRJEJOBh n OLD JOBS PURGED THUS FAR. 
An error. has occurred during PURGE processing which 
makes directory/job log update impossible. However, n 
Old jobs have already been deleted from the Job log. 
Rebuild the configuration files for this host using 
the NEW command. 


s<current command char> MUST BE FIRST CHAR IN USER HOST cD. 
The specified. command character must be the first 
character entered in the user host command. For 
example, if the host system command character is a 
dollar sign ($), the User host command cannot be &DA. 


NO BLANKS ALLOWED IN FORMAL FILE DESIGNATOR 
Embedded blanks are not permitted within a back 
referenced file designator. Re-enter. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 


interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


* NO CLOSING QUOTE ON DEVICE CLASS NAME. 


Valid device class must be enclosed in quotes. 
Re-enter. 


* NO FILE DESIGNATOR ON ##FD CARD. 


* NO JOB 


A ##FD card with no file designator has been found in 
a SUBMIT input file. Correct the ##FD card and 
re-submit. 


CARD FOUND. 

DSN/MRJE has read and spooled or transmitted all 
SUBMIT input (Infiles and FD files) without finding a 
host JOB card with the form: 


//jobname JOB optional information 
Add a valid host job card and re-SUBMIT. 


FILES CREATED. 

If an error occurs or the DSN/MRJE Manager enters 
Control-Y during NEW command processing, no new set of 
configuration files is created. If new files are re- 
quired, determine the reason for failure from the MPE 
file error number given in the I/O error message and 
re-enter the NEW command. 


* NO PARAMETERS ALLOWED. 


No parameters are allowed in this command. Re-enter 
the command. 


NO SPOOL FILE FOUND. 


Message occurs when a job is canceled and no_ spool 
file exists that contains information to be trans- 
mitted for the canceled job. 


jobname NOT FOUND. 


The job named in a CANCEL or DISPLAY command is not in 
the job log. Ensure that job name is correct and 
re-enter the command. The Manager may DISPLAY the 
entire job log to check job names. 


NOTE 


An asterisk (*) preceding a message indicates the error 


causes 


program termination if DSN/MRJE is being run non- 


interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


JOB NOT SUBMITTED. 
jobname 


The named job (or "JOB" if DSN/MRJE did not find a 
host card) was not submitted to the host. Make 
certain the job has a recognizable job card. 


NOTRANSLATE CAN'T BE SPECIFIED FOR SSTDIN/SSTDINX. 
Input from the standard input file is always trans- 
lated from ASCII to EBCDIC or EBCDIK, depending on 
translation type. Re-enter SUBMIT command, deleting 
the "(NOTRANSLATE)" parameter from SSTDIN/SSTDINX. 


"“NOTRANSLATE" REQUIRED. 
"(NOTRANSLATE)" or "(TRANSPARENT)" are the only paren- 
thesized parameters allowed in the SUBMIT command. 
Re-enter command. 


NUMERIC PARAMETER EXPECTED. 
Numeric input is expected after a comma. Re-enter. 


ONLY 3 PARAMETERS ARE ALLOWED. 
Only three values (days, hours, minutes) can be given 
to specify maximum time a job remains in the job log 
after transmittal. Re-enter. 


outfile : OUTPUT FILE DOES NOT EXIST. 
The named output file (PRINT, PUNCH, or FORMS file) 
has been given in a SUBMIT command, but has not yet 
been created. Build the named output file and 
resubmit. 


PARAMETERS REQUIRED. 
The given command requires parameters. Re-enter the 
command . 


PRINT SPECIFIED TWICE. 
PRINT file specified twice in SUBMIT command. Reenter 
command, specifying "PRINT" once only. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 


* PUNCH SPECIFIED TWICE 
PUNCH file specified twice in SUBMIT command. Reenter 
command, specifying "PUNCH" once only. 


* reader READER CANNOT BE CLOSED. 
The named host pseudo reader cannot be closed. Deter- 
mine the reason for the failure from MPE file error 
number. 


* READER SPECIFIED TWICE. 


READER file specified twice in SUBMIT command. 
Reenter command. 


SPOOL FILE DELETED. mh 


Message occurs when a job is canceled before it is 
transmitted to the host and the spool containing it is 
deleted. | 


SPOOL FILE NOT IN READY STATE. UNABLE TO DELETE. 
Message occurs when a job is canceled while it is 
being transmitted to the host. The spool file is busy 
and cannot be deleted. 


* STANDARD INPUT FILE CAN'T BE OPENED. FATAL ERROR! 7 
SSTDINX cannot be opened. DSN/MRJE terminates. 


* STANDARD INPUT FILE CAN'T BE OPENED FOR NOWAIT 1/0. 


SSTDINX must be opened for NOWAIT I/O in order to send 
host console commands. 


* SSTDIN, SSTDINX, SOLDPASS ARE ONLY SYSTEM INPUT FILES 
ALLOWED. = 
Only those system files named in the message can be | 
used for Input or FD files. Other System files are 
prohibited. Re-enter SUBMIT with valid input files. 


* THIS ITEM NOT DYNAMICALLY CONFIGURABLE. ad 
Items 1, 18, 40, and 41 in the configuration file 
cannot be altered after the file has been created. In 
order to change these items, use the NEW command to 
reconstruct the configuration file. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) 

















USER CAPABILITY IN EFFECT. 
This user does not have “OP" capability, and cannot 
Carry out DSN/MRJE Manager functions. 






VALID RESPONSE MUST BE GIVEN. 

When creating a new set of configuration files, items 
that do not have default values must be initialized. 
DSN/MRJE continues to ask for a valid response until 
one is given or until the Manager enters Control-Y, in 
which case no new files are created. 


VERIFY CANCEL WITH "YES". 
When User/Manager requests that a job be canceled, the 
job log entry is displayed. In an interactive session 
DSN/MRJE then asks for verification of the CANCEL. 

Reply YES to verify cancellation. 


WARNING: HOST COMMAND CARD FOUND IN INPOT-NOT TRANSMITTED. 
DSN/MRJE did not transmit the record to the host. 
SUBMIT processing continues. 













WARNING: MRJEOD CARD FOUND IN INPUT-NOT TRANSMITTED. 
An MRJEOD card is only required when an input file 
(Infile or FD file) is SSTDIN or SSTDINX. If an 
MRJEOD card is found in any other input file it is not 
transmitted to the host. SUBMIT processing continues. 


WARNING: SIGNOFF CARD FOUND IN INPUT-NOT TRANSMITTED. 
A signoff card has the form: 


/*SIGNOFF 







DSN/MRJE did not transmit this record to the host. 
SUBMIT processing continues. 





"YES" OR "NO" REQUIRED. 
YES or NO is the only valid response. Re-enter. 






NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-1. DSN/MRJE User Messages (continued) ) 








* YOU MUST LOG ON MANAGER.SYS TO CREATE/PURGE CONFIG FILES. 
The MRJE Manager must be logged on to MANAGER. SYS, PUB 
to create a set of configuration files (NEW command) 
or to purge all entries from the job log (PURGE ALL), 
Since the files are in PUB.SYS. 









NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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Table 6-2. MRJECONTROL Console Messages 


The messages in this table can be received by DSN/MRJE users 
while using :MRJECONTROL commands. 


CIERR (OR) MESSAGE, MEANING AND RECOVERY 
NUMBER 
4200 EXPECTED ONE OR MORE OF THE CONTROL FUNCTIONS: 


START, TRACE, RETRIES, SIGNOFF OR KILL. 
Entering "MRJECONTROL" alone is not OK. Enter 
"MRJECONTROL" plus one of the control commands 
listed in the message. 


4201 EXCEEDED MAXIMUM NUMBER OF PARAMETERS. 
Look up syntax of DSN/MRJE command and reenter 
using no more than the maximum number of 
parameters allowed. 





4202 START ALREADY REQUESTED. 
The :MRJECONTROL START command has already 
been issued, but the line is not fully open. 
Before the command can again be successfully 
‘eo issued, the :MRJECONTROL SIGNOFF or 
sMRJECONTROL KILL command must be executed. 


4203 EXPECTED TWO PARAMETERS, HOSTID AND RETRYNUM. 
Re-enter command using both parameters. 

4204 UNABLE TO OPEN CONFIGURATION FILE FOR THIS 
HOST. 
There are several possible reasons for this 
message: 





1) The wrong host ID may have been used in 
command. 

2) Someone may be altering or rebuilding 
the configuration file. 

3) There may be no configuration file for 
this host. 


4205 UNABLE TO ACCESS CONFIGURATION FILE FOR THIS 
HOST. 
An FWRITE to or FREAD from the file failed. 


4206 INSUFFICIENT CAPABLITIES FOR MRJECONTROL 
COMMANDS. 
A user must be authorized to use MRJECONTROL 
, commands through the MPE :ALLOW command. 
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Table 6-2. MRJECONTROL Console Messages (continued) 


CIERR(OR) 


MESSAGE, MEANING AND RECOVERY 
NUMBER 





4207 


4208 


4209 


4210 


4211 


4212 


4213 


4214 


4215 


4216 


4217 
4218 


UNABLE TO CREATE MRJEMON. 
Do a LISTF on MRJEMON.PUB.SYS to see if file 
exists. If it doesn't, check MPE configuration. 


UNABLE TO ACTIVATE MRJEMON. 
Do a LISTF on MRJEMON.PUB.SYS to see if file 
exists. If it does, check MPE configuration. 


MRJE ALREADY ACTIVE. 
Line already open. Command is ignored. 


NUMBER OF RETRIES MUST BE IN RANGE 1 —- 255. 
Re-enter command with "RETRIES" within range. 


SIGNOFF ALREADY REQUESTED. 
Command in process. If line won't close, it may 
be necessary to issue :MRJECONTROL KILL. 


KILL ALREADY REQUESTED. 

sMRJECONTROL KILL command already has been re- 
quested. If line won't close, it may be neces- 
sary to physically disconnect it. 


INVALID DEVICE FOR MRJEO. 

The logical device numbers for items 2 and 3 of 
the configuration file differ those in the MPE 
I/O system configuration. Alter the configura- 
tion file. | 


EXPECTED AT LEAST ONE PARAMETER, "ON" OR "OFF". 
Issue TRACE with an "ON" or an "OFF", 


MRJE NOT ACTIVE. 


Start DSN/MRJE (:MRJECONTROL START) and then re- 
issue command. 


NO SYSTEM BUFFER AVAILABLE. COMMAND FAILED. 
Re-issue command until it succeeds. If problem 
persists, contact Hewlett-Packard. 

"TRACE" ONLY VALID COMMAND HERE. 


MRJEMON ADOPT FAILURE. 
Contact Hewlett-Packard. 
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MRJECONTROL Console Messages (continued) 


MESSAGE, MEANING AND RECOVERY 


HOST ID MUST BE ALPHANUMERIC. 
Host ID may not contain a special character. 


SIGNOFF INVALID UNTIL HOST CONNECTION COMPLETED. 
sMRJECONTROL SIGNOFF cannot be executed until 
the communications line is open. 
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Table 6-3. DSN/MRJE Messages Sent to System Console 





NOTE 


A number of DSN/MRJE messages are sent to the system 
console only. The messages have the following format: 











time/pin/MRJEh message 





Or 


time/pin/MRJEh WARNING: message 





or 





time/pin/MRJEh ERROR: message 







Message items are: 








time The time of day the message was sent. 






pin The MPE process identification number. 





MRJE Indicates DSN/MRJE generated the message and that 
the message concerns the default host system. 







MRJEh Indicates DSN/MRJE generated the message and 
that the message concerns the host system whose 
ID begins with the alphanumeric character h. 








message The message itself. 





WARNING: This message reports a potential problem. 





ERROR: This message reports a failure. 









ACTIVATE FAILURE ON MRJEMON. 
Internal software error. Contact Hewlett-Packard. 










CONFIGURED BUFFER SIZE INVALID. 
Buffer size in the MRJE configuration file (Item 43) 
is invalid. The MRJE Manager must alter the item in 
the configuration file to agree with the host system's 
buffer size. 











CONSMRJE, OPEN FAILURE (nn) ON SNULL. 
File system error nn. Contact Hewlett-Packard. 
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Table 6-3. DSN/MRJE Messages Sent to System Console (continued) 


CONSMRJE, OPEN FAILURE (nn) ON MRJECONh. 
The specified MRJE configuration file could not _ be 
opened; see if it exists. If it does, determine the 
cause of the the failure from the file system error 
number (nn) and take corrective action. 


CONSMRJE, READ FAILURE (nn) ON MRJECONh. 


File system error nn. If severe, contact Hewlett- 
Packard. 

CONSMRJE, WRITE FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, contact Hewlett- 
Packard. 





CREATE FAILURE ON MJOBLOGR. 
A job-logging process could not be created. Ensure 
that MRJELOGR is present in PUB.SYS. 


CREATE FAILURE ON MRJEMON. 
An DSN/MRJE monitor process could not be created. 
Ensure that MRJEMON is present in PUB.SYS. 


CREATE FAILURE ON MRJEOUT. 
An DSN/MRJE output process could not be created. 
Ensure that MRJEOUT is present in PUB.SYS. 





CS, OP AND SM REQUIRED TO RUN MRJEMON 
The MRJE Monitor process can only be run by ae user 
whose capabilities include CS, OP, and SM. 


DATA RECEIVED FOR INVALID UNIT #nn. 

The host system has sent data to an_ unconfigured 

pseudo device. 

1. Backspace the host unit (nn). 

2. Drain host unit (nn). | 

3. As soon as convenient, reconfigure the DSN/MRJE 
pseudo I/O devices so that the host and the HP 
3000 system have the same configuration. 





DSN/MRJE pseudo devices should be configured with the 
following unit numbers: 


2 pseudo console 
3 thru 9 pseudo line printers 1 thru 7 
10 thru 16 pseudo punches 1 thru 7 
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Table 6-3. DSN/MRJE Messages Sent to System Console (continued) 


DIAL REMOTE number. 
The communications link has been initially estab- 
lished. Dial the number shown in the message and com- 
plete the connection. This message is printed only if 
the INP or SSLC is configured for a switched (not a 
leased) line. 


FINAL TERMINAL SIGNOFF 
The remote computer issued a sign off to MRJE. 


HOST BLOCK SEQUENCE (nl1,n2). 
A block sequence error occurred on the CS device. 
Block n2 was received when block nl was expected. 
Normally, MRJE will recover from this condition. Tf 
the problem recurs, contact Hewlett-Packard. 


HOST BUFFER SIZE (nnnn) EXCEEDS MAXIMUM. 
The value specified in the MRJE configuration file for 
the host buffer size is greater than 2048. The MRJE 
Manager should alter Item 43 in the configuration 
file. 


HOST ID IS TOO LONG 
When a RUN MRJEMON;INFO="h" was issued, the "h" was 
more than one character long. 


HOST # NOT ENTERED FOR 3000 JOB #nnn. 
All output received from job nnn was sent to one of 
the unsolicited output device specified in MRJE con- 
figuration file. 


INVALID BUFFER RECEIVED FROM HOST. 
The last buffer of data received from the host had 
contradictory or invalid control information. Contact 
Hewlett-Packard. 


INVALID DEVICE FOR MRJEO. 
The logical device number configured in the MRJE con- 
figuration file for the pseudo line (Item 3) is not 
the same as the number configured into MPE for 
IOMRJEO. The MRJE Manager must alter the logical 
device number in the configuration file (#ALTER 
command). 

INVALID LDEV NUMBER n 
Logical device number "n", referenced by MRJE, has not 
been configured within the system. 








- 
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Table 6-3. DSN/MRJE Messages Sent to System Console (continued) 


KILL ALREADY REQUESTED. 

The :MRJECONTROL KILL message has already been issued, 
but it was unsuccessful. Subsequent KILL commands for 
the same host cause this message. If MRJE does not 
disconnect the line, you may need to physically dis- 
connect it. If MRJE repeatedly fails to close the 
line after the KILL command is issued, contact 
Hewlett-Packard. 


LOCKSEG FAILURE. 


LOCKSEG Intrinsic failure. Internal software problem. 
Contact Hewlett-Packard. 


nl BLOCK SEQUENCE. RECOVERY. EXPECTED BLOCK n2. 

RECEIVED BLOCK n3. 
While data was being transmitted to the host’ system, 
block n3 was received when block n2 was to have been 
sent. There were nl blocks recovered. MRJE will nor- 
mally recover from this condition. If the problem 
persists, contact Hewlett-Packard. 


MRJELOGR, FINFO FAILURE (nn) ON MRJEDIRh. 


Pile system error nn. If severe, contact Hewlett- 
Packard. 


MRJELOGR, JOB TRANSMITTED TO WRONG HOST. 
In HP 3000 systems configured with two or more MRJE 
subsystems, jobs can be transmitted to the wrong host 
if the same pseudo card reader is configured in more 
than one MRJE configuration file. 


MRJELOGR, OPEN FAILURE (nn) ON SNULL. 


File system error nn. If severe, contact Hewlett- 
Packard. 


MRJELOGR, OPEN FAILURE (nn) ON MRJECONh. 


File system error nn. If severe, contact Hewlett- 
Packard. 

MRJELOGR, OPEN FAILURE (nn) ON MRJEDIRh. 
File system error nn. If severe, contact Hewlett- 
Packard. 

MRJELOGR, OPEN FAILURE (nn) ON MRJEJOBh. 
File system error nn. If severe, contact Hewlett- 
Packard. 
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Table 6-3. DSN/MRJE Messages Sent to System Console (continued) 
MRJELOGR, READ FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


MRJELOGR, READ FAILURE (nn) ON MRJEDIRh. 


File system error nn. If severe, contact Hewlett- 
Packard. | 
MRJELOGR, READ FAILURE (nn) ON MRJEJOBh. 
File system error nn. If severe, contact Hewlett- 
Packard. 
MRJELOGR, WRITE FAILURE (nn) ON MRJEDIRh. 
File system error nn. If severe, contact Hewlett- a, 
Packard. 
MRJELOGR, WRITE FAILURE (nn) ON MRJEJOBh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


MRJEMON, OPEN FAILURE (nn) ON CS DEVICE. 
The MRJE monitor could not open the line. The CS 


error number (nn) references the reason for the oN 
failure. CS error codes are listed in Tables 6-4 and 
6-5. 
MRJEMON, OPEN FAILURE (nn) ON SNULL. 
File system error nn. If severe, contact Hewlett-— 
Packard. 


MRJEMON, OPEN FAILURE (nn) ON MRJEO. 
The DSN/MRJE pseudo line monitor file could not be 
opened. (nn) specifies the MPE file system error num- 
ber which identifies a reason for the failure. If the 
problem is severe, contact Hewlett-Packard. 





MRJEMON, OPEN FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


MRJEMON, READ FAILURE (nn) ON CS DEVICE. 
The communication link to the host failed. The cS 
error number (nn) identifies the reason for the fail- 
ure. CS errors are listed in Tables 6-4 and 6-5. If 
the problem is severe, contact Hewlett-Packard. 


MRJEMON, READ FAILURE (nn) ON MRJEO. 
File system error nn. If severe, contact Hewlett-— es 
Packard. 

















MRJEMON, 


MRJEMON, 


MRJEMON, 


MRJEMON, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 
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READ FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, 
Packard. 


contact Hewlett-— 


WRITE FAILURE (nn) ON CS DEVICE. 

If this message appears as a WARNING, a communication 
problem developed and DSN/MRJE sent a SIGNOFF command 
prior to disconnecting the line. The host system 
probably has accepted the command and is closing the 
communications link. 


If this message appears as an ERROR, the communica- 
tions link failed unexpectedly. Irrecoverable commun- 
ication error codes are listed in Table 6-4. The CS 
error number references the reason for the failure. 
Contact Hewlett~Packard, if such errors persist. 


WRITE FAILURE (nn) ON MRJEO. 


File system error nn. If severe, contact Hewlett- 
Packard. 

WRITE FAILURE (nn) ON MRJECONh. 

File system error nn. If severe, contact Hewlett-— 
Packard. 

CLOSE FAILURE (nn) ON MRJECONh. 

File system error nn. If severe, contact Hewlett- 
Packard. 

FINFO FAILURE (nn) ON MRJE'PNLP. 

File system error nn. If severe, contact Hewlett- 
Packard. 

FINFO FAILURE (nn) ON MRJEOUT. 

File system error nn. If severe, contact Hewlett- 
Packard. 

OPEN FAILURE (nn) ON S$NULL. | 

File system error nn. If severe, contact Hewlett- 
Packard. 

OPEN FAILURE (nn) ON MRJE'PNLP. 

File system error nn. If severe, contact Hewlett- 
Packard. 

OPEN FAILURE (nn) ON MRJECONh. 

File system error nn. If severe, contact Hewlett-— 


Packard. 
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MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJESTRh 
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OPEN FAILURE (nn) ON MRJEDIRh. | 
File system error nn. If severe, contact Hewlett-— 
Packard. 


OPEN FAILURE (nn) ON MRJEJOBh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


OPEN FAILURE (nn) ON MRJEOUT. 

DSN/MRJE couldn't open a User's output file. Output 
destined for the file is irrecoverable. Notify DSN/ 
MRJE Users that output was lost. This is file system 
error nn. If severe, contact Hewlett-Packard. 


READ FAILURE (nn) ON MRJE'PNLP. 
File system error nn. If severe, contact Hewlett- 
Packard. 


READ FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


READ FAILURE (nn) ON MRJEDIRh. 
File system error nn. Contact Hewlett-Packard. 


READ FAILURE (nn) ON MRJEJOBh. 

When nn=0, it indicates that unsolicited output that 
doesn't belong to any entry in the job log file was 
received. When nn does not equal zero, an internal 
software error has occurred. In the latter case, con- 
tact Hewlett-Packard. 


WRITE FAILURE (nn) ON MRJE'PNLP. 
This message should be ignored. 


WRITE FAILURE (nn) ON MRJEOUT. 

DSN/MRJE couldn't write to a user's file. Output des- 
tined for the file is irrecoverable. Notify DSN/MRJE 
users that output was lost. Contact Hewlett-Packard. 


FILE DOES NOT EXIST 

An MRJECONTROL START,h has been issued, but there is 
no stream file MRJESTRh for host id h. The stream 
file is used to initiate MRJE communication with the 
host system. 
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DSN/MRJE Messages Sent to System Console (continued) 


NO 3000# FOR HOST JOB# nnnn, jobname. 


Internal software problem. All output received for 
JOB# mnnn was sent to the unsolicited output devices 
specified in the DSN/MRJE configuration file. If the 
problem is severe, contact Hewlett-Packard. 


NO SYSTEM BUFFER FOR SIGNOFF. 


An :MRJECONTROL SIGNOFF command failed because no HP 
3000 system buffers were available. Wait and try 
again. If this problem occurs frequently, contact 
Hewlett-Packard. 


PHYSICAL BOUNDS OF OUTFILE EXCEEDED FOR IBM JOB nnnn PLEASE 
RESPOND "RETRY" OR "FLUSH". 


The file specified to receive output for host job nnnn 
appears to be full. Writing to the file is suspended 
until the console operator responds to the message. A 
FLUSH response causes the remaining job output to be 
sent from the host, but the data is lost. Notify the 
owner of job nnnn that output was lost. A RETRY re- 
sponse causes the system to attempt to rewrite the 
lost record. Use RETRY only after attempting to iden- 
tify and rectify the cause of the message. If the 
rewrite fails, this message is repeated until a retry 
is successful or until a FLUSH response is given. 


PRINTER O TERMINATING. 


Internal software error. A printer or punch output 
process terminated, but DSN/MRJE cannot determine 
which one. Contact Hewlett-Packard. 


PRINTER n TERMINATING. 


Internal software error. The DSN/MRJE output process 

corresponding to printer n terminated. 

1. If no SIGNON COMPLETED message has been received, 
enter the :MRJECONTROL KILL [,hostid] command. 

2. If a SIGNON COMPLETED message has been received, 
backspace host printer n to the beginning of the 
data set. 

3- Drain all host printers and punches. 

4. Enter the :MRJECONTROL SIGNOFF [,hostid] command. 

5. In either case, contact Hewlett-Packard. 
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Table 6-3. DSN/MRJE Messages Sent to System Console (continued) 


PUNCH n TERMINATING. 

Internal software error. The DSN/MRJE output process 

corresponding to punch n terminated. 

1. If no SIGNON COMPLETED message has been received, 
enter the :MRJECONTROL KILL [,hostid] command. 

2. If a SIGNON COMPLETED message has been received, 
backspace host punch n to the beginning of the 
data set. 

3. Drain all host printers and punches. 

4. Enter the :MRJECONTROL SIGNOFF [,hostid] command. 

5. In either case, contact Hewlett-Packard. 


SIGNOFF ALREADY REQUESTED. 


The :MRJECONTROL SIGNOFF command has already been “_ 
entered. (If the SIGNOFF command is issued while the , 
host is transmitting, transmission continues until the 

current data set has been received: then the line is 
disconnected. ) 


SIGNON COMPLETED. 
The sMRJECONTROL START command has successfully execu- 
ted and the communication link is now open. If jobs 
have been submitted, DSN/MRJE will automatically begin 
transmitting data and accepting output. 





SYSTEM ALREADY ACTIVE. 
The s:MRJECONTROL START command was issued for a host 
that is already connected. 


SYSTEM NOT ACTIVE. 
The sMRJECONTROL SIGNOFF (or KILL) command was’ issued 
for a host that is not connected. 





TERMINATING. 
The DSN/MRJE monitor process terminated. When printed 
alone (that is, without an accompanying ERROR or 
WARNING message), the termination was normal. 
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Table 6-3. DSN/MRJE Messages Sent to System Console (continued) 


UNABLE TO OPEN UNSOLICITED OUTPUT FILE FOR IBM JOB nnnn 

PLEASE RESPOND “RETRY” OR "FLUSH". 
The device or file specified to receive unsolicited 
output cannot be opened. The output procedure is sus- 
pended until the Console Operator responds to the 
message. A FLUSH response restarts output from the 
host, but all data is lost. Notify the owner of job 
nnnn that output was lost. A RETRY response causes 
the system to try again to open the device or file. 
Use RETRY only after attempting to identify and recti- 
fy the cause of the message. If the specified device 
file still cannot be opened, this message is repeated 
until RETRY is successful or until a FLUSH response is 
given. 





UNLOCKSEG FAILURE. 
The UNLOCKSEG intrinsic failed. Internal software 
error. 
1. COOLSTART the system (to reclaim the line moni- 
tor's stack). 
2- Contact Hewlett-Packard. 


ZSIZE ERROR. 
The ZSIZE intrinsic failed. Internal software error. 
Contact Hewlett-Packard. 
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Table 6-4. CS Irrecoverable Error Codes 


Irrecoverable Error codes are divided into the eight general cat- 
egories listed at the beginning of this table. The individual 
and their meanings are listed in the second part of the 
Any which occur frequently should be reported to Hewlett- 


















1 through 40 The communications software could not open the 
line (COPEN failed), possibly due to incorrect 


MPE I/O system configuration. 





through A CS Intrinsics error occurred perhaps associ- 


ated with opening the line. Contact Hewlett- 
Packard. 








through A CS Intrinsics error occurred which did not 
involve opening the line (COPEN was not 


involved). Contact Hewlett-Packard. 








through 109 A hardware error occurred or an INP self-test 


failed. 






through The INP trace process detected errors. 











The mainframe interconnect (IC) detected an 


through 124 
error. 





through An error or exceptional condition caused the 


line to be disconnected. 





through An error or exceptional condition occurred but 


the Line was not disconnected. 


ERROR CODE DESCRIPTION 


Not enough stack space to process the line opening. 


Invalid driver name. 


Driver not found. 


oOo wn HD VI 


Driver not compatible with the attributes of the 
communication line. Reconfigure the communications 
interface (refer to Appendix D). 
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( Table 6-4. CS Irrecoverable Error Codes (continued) 


ERROR CODE DESCRIPTION 


Driver not changeable. Reconfigure MPE and specify 
DRIVER CHANGEABLE? YES for the SSLC driver. (Note: 
the INP driver may not be configured as 
“changeable”. ) 


Undefined device. Reconfigure MPE to include a 
communications controller. 


Device not available. Device may be in use by an- 
other process, or the logical device for the commu- 
nications controller has been brought down (:DOWN). 
In the latter case, the console operator’ should 
bring the device up again (use :UP command). 
Not a CS device. 

Line in use by another subsystem. The console 
operator must terminate the other subsystem before 
the line can be used for DSN/MRJE activity. 

Invalid ID sequence length. 

Invalid buffer size. 

Invalid phone number length. 

Illegal character in phone number. 

The line configuration is not compatible with the 
physical line. Reconfigure MPE. (Refer to 
Appendix D.) 

Invalid information type in MISCARRAY. 

Invalid information value in MISCARRAY. 


Could not open trace file. 


Trace process unable to get/lock/freeze extra data 
segment. 


Invalid user capability. 
Invalid line designator. 


No designator or device specified. 
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Table 6-4. CS Irrecoverable Error Codes (continued) 


ERROR CODE DESCRIPTION 


Too many files/lines. 





Insufficient memory space. 
Driver failed to open line. 


Local mode was control station, but SUPLIST para- 
meter was not specified. 


Down-load file error. 
HP 3000 trace process not created/active. 
Not enough INP buffer space. 


No virtual memory available for trace and/or 
buffering. 


DB not pointing at stack. 

Need process handling capability to trace. 
Invalid line number - no such line. 
Invalid parameter value. 

Trace process detected a read error. 
Autodialer detected errors. 

Buffer or count not specified. 

Invalid buffer count parameter. 

No answer to dial attempt. 

No phone list for dial attempt. 

Bad dial message. This is a system problem. 
Invalid array length parameter. 

Bad CCONTROL code. 

No I/O in progress for abort. 


Abort ignored. 
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: Table 6-4. CS Irrecoverable Error Codes (continued) 


ERROR CODE DESCRIPTION 


70 Exceeds maximum writes allowed outstanding. 





Exceeds maximum reads allowed outstanding. 
Parameter bounds violation. 

No CS buffers remaining. 

Buffer parameter required but not specified. 


Maximum number of I/O requests is already outstand- 
ing. Must first issue IOWAIT. 





No I/O pending for any file/line. 
No I/O pending for specified file/line. 
Illegal operation on INP device. 


File system error in INP dump. 





INP USYNRT failure with DMA. 

INP parity error. 

INP RAM software error. 

INP received bad self-test control character. 


INP DMA self-test error. 





INP microprocessor (MC2) failure. 
INP ROM failure. 

INP RAM failure. 

INP USART transmitter overrun. 

INP USART parity error. 

INP USART self-test receive error. 


INP USYNRT self-test transmitter underrun. 
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Table 6-4. CS Irrecoverable Error Codes (continued) 


ERROR CODE DESCRIPTION 


96 INP USYNRT self-test receive error 





INP USYNRT self-test receive overrun. 

INP USYNRT self-test receive aborted. 

INP USART self-test received no data. 
Non-responding device. 

Transfer error. 

Data set not ready. Indicates remote system dis- 
connected the line, or some sort of problem 


developed with the modem. 


Carrier loss. The modem may have disconnected or 
the phone line has a problem. 


Data overrun on the communications interface. 
INP USYNRT received no data. 

INP USART failure with DMA. 

Timer failure. 

INP RAM parity skeen. 

INP has no memory for trace buffers. 
Illegal number of trace buffers requested. 
Illegal start/stop requests. 

Tilegal trace record size specified. 

Power failure during down load. 

Mainframe IC driver timed out. 

Invalid interrupt. 


Start/stop I/O program error. 
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Table 6-4. CS Irrecoverable Error Codes (continued) 
Power failure recovery error. 
Internal driver error. 
ROM self test error. 
HPIB error. 
GIC error. 


Reset while in RAM. 





Connect timeout. Line connection did not occur in 
the time set during MPE configuration. 


Remote rejected the connection. 
Power failure. 


Local timeout. 





An internal error was detected by the CS driver. 


Remote terminal protocol error. The line 
disconnected. 


Remote terminal sent shutdown sequence and 
disconnected. 


Remote terminal sent shutdown sequence and discon- 
nected before I/O request was issued. 


An internal error was detected by MPE. 
Initialization timer expired. 

Operation aborted. 

Invalid user request. 

Remote is not ready to accept line bid. 
Remote rejected the line bid. 


Remote primary station bid for the line while local 
user was also bidding. 
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Table 6-4. CS Irrecoverable Error Codes (continued) 


ERROR CODE DESCRIPTION 


206 Remote has requested to send (an RVI sequence was 
received). 





Transmission retry count was exhausted. If this 
recurs, it may be necessary to set a higher retry 
limit (use :MRJECONTROL RETRIES). 


Unexpected text was received from a terminal. 


Receive timeout. An expected response froma _ ter- 
minal did not occur. 





Remote terminal sent end-of-transmission. 


Remote sent end-of-—transmission sequence and dis- 
connected before the I/O request was issued. 


During the execution of a CWRITE conversational 
with output buffer specified to also be the input 
buffer, the remote requested a resend of the out- 
put buffer but the contents had been modified a 
while receiving from the remote. 


Remote sent an ACK sequence in response to _ local 
CREAD acknowledgement. 


Remote sent a NAK sequence in response to a local 
CREAD acknowledgement. 


Remote sent an RVI sequence in response to local 
CREAD acknowledgement. 





Remote requested a download sequence be initiated. 


No line bid was received from the remote causing a 
local timeout. 


Remote sent a delay sequence instead of the expec- 
ted text/response. 


An EOT was received from the remote before the 
last block of a multiblock transmission was sent. 


A terminal was requested to wait before transmit- 
ting text but ignored the request and sent text 


anyhow. 
“) 
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Table 6-4. CS Irrecoverable Error Codes (continued) 


ERROR CODE DESCRIPTION 
223 Too much data was transmitted by the remote; part 
of the data was lost. 


















CS Error Codes 


Table 6-5. CS Recoverable Error Codes 


ERROR CODE DESCRIPTION | 


No error occurred. 





Invalid ID sequence received. 
Received unintelligible sequence. 


Block check character or field check sequence 
error. 


Response timeout. 
Received incorrect acknowledgement. 


Received unintelligible sequence after sending 
text. 


Received enquiry character after sending text. 


Remote requested a resend of local's last 
response. 


Remote requested resend of last text block. 


Received end-of-transmission character while in 
control state. 


Received text overflow. 


Data overrun occurred on SIO multiplexer. 


Transfer error occurred on the SIO multiplexer. 


Data overrun on the INP interface board. 


Data underrun on the INP interface board. 
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DSN/MRJE Message Catalog 


The message catalog file is used by DSN/MRJE for both error 
messages and information messages. The file MRJECAT.PUB.SYS is 
the message catalog for DSN/MRJE. The method of maintaining file 
MRJECAT.PUB.SYS is discussed in the "MPE Intrinsics Reference 
Manual" (HP 30000-90010) Section 4, in the discussion of the MPE 
Message System. The contents of file MRJECAT.PUB.SYS are shown 
in Table 6-6, "DSN/MRJE Message Catalog", which follows. 


Table 6-6, DSN/MRJE Message Catalog 


IF YOU PLAN TO CHANGE THE CONTENTS OF THE FILE, PLEASE 
OBSERVE THE FOLLOWING: 


THE FILE MUST BE BUILT FROM A STANDARD NUMBERED EDITOR FI 

NO MESSAGE CAN BE LONGER THAN 1024 CHARACTERS 

NO LINE OF A MESSAGE CAN BE LONGER THAN 56, 66 AND 66 FOR 
THE MASTER CONSOLE, SUBSYSTEM AND HELP FACILITY SETS. 

"\&" MUST BE PUT AT THE END OF A LINE OF A MESSAGE EXCEPT 
FOR THE LAST, TO ACT AS A LINE DELIMITER. 

NEVER DELETE OR ADD ANY “!“ CHARACTERS IN THE FILE. 

NEVER CHANGE ANY MESSAGE OR SET NUMBERS WITHIN THE FILE 

RUN MAKECAT.PUB.SYS TO REBUILD THE MRJECAT FILE. 

REFER TO THE MPE INTRINSIC MESSAGE SYSTEM. 


DPN ANAONDNnNMNNnN1MM 
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Table 6-6, DSN/MRJE Message Catalog (continued) 


MESSAGE 1 TO 62 FOR MASTER CONSOLE 
! ERROR: CONFIGURED BUFFER SIZE INVALID 
! ERROR: CREATE FAILURE ON ! PROCESS 
!: DIAL REMOTE ! 
1 ERROR: LOGSEG FAILURE 
1 SIGNON COMPLETED 
1 ERROR: HOSTBUFFER SIZE (!) EXCEEDS MAXIMUM 
CONF IGURATION | 
WARNING: ! BLOCK SEQUENCE ERROR RECOVERY, 
EXPECTED BLOCK !, RECEIVED BLOCK ! | 
ERROR: ZSIZE ERROR 
ERROR: UNLOCKSEG FAILURE 
ERROR: NO SYSTEM BUFFER FOR SIGNOFF 
MRJE TERMINATING. . . 
ERROR: INVALID DEVICE FOR MRJEO 
ERROR: MRJE ALREADY ACTIVE. 
ERROR: CREATE FAILURE ON MRJEMON 
ERROR: ACTIVATE FAILURE ON MRJEMON 
WARNING: SIGNOFF ALREADY REQUESTED 
WARNING: KILL ALREADY REQUESTED 
WARNING: SYSTEM NOT ACTIVE 
ERROR: HOST # NOT ENTERED FOR 3000 JOB# ! 
ERROR: NO 3000# FOR HOST JOB# !,1 
ERROR: ! ! TERMINATING. . . 
ERROR: DATA RECEIVED FOR INVALID UNIT# ! 
ERROR: INVALID BUFFER RECEIVED FROM HOST 
ERROR: (MRJELOGR) JOB TRANSMITTED TO WRONG HOST 
ERROR: SON PROCESS DEAD 
WARNING: MRJECONTROL KILL REQUESTED 
FINAL TERMINAL SIGNOFF 
ERROR: MRJESTR! DOES NOT EXIST 
ERROR: CS, SM AND OP REQUIRED TO RUN MRJEMON 
ERROR: HOST ID ! IS TOO LONG 
ERROR: INVALID LDEV NUMBER |! 


! 
! 
! 
! 
! 
| 
! 
! 
! 
! 
! 
! 
! 
! 
! 
| 
! 
! 
! 
! 
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Table 6-6, DSN/MRJE Message Catalog (continued) 


SSET 2 MESSAGE 1 TO 62 FOR MRJE SUBSYSTEM 

1 MANAGER CAPABILITY IN EFFECT 

2 USER CAPABILITY IN EFFECT 

3 FILE ALREADY EXISTS REPLY "YES" TO RECREATE. 

4 FOLLOWING MUST BE INITIALIZED IN CONFIGURATION FILE: 

5 DEFAULT HOST ASSUMED 

6 IS OFFLINE 

7 VERIFY CANCEL WITH "YES". 

8 IS CURRENT HOST MACHINE 

9 WARNING: SIGNOFF CARD FOUND IN INPUT. NOT TRANSMITTED. 
10 FILES CREATED. 

ll SUCCESSFULLY ALTERED 

12 IS ON LINE 

13 ENTER INPUT ENDING WITH "MRJEOD" 

14 END OF FILE 

15 WARNING: MRJEOD FOUND IN INPUT. CARD IS NOT TRANSMITTED. 
16 CAN'T BE CLOSED 

17 NOT FOUND 

18 JOBLOG IS EMPTY 

19 :DUPLICATE JOBNAMES IN JOBLOG. CANCEL REFUSED. A DISPLAY 
20 OF JOBS WITH THIS NAME WHICH YOU OWN (IF ANY) FOLLOWS: 
21 NOT SUBMITTED 

22 JOB NOT CANCELED. 

23 IS NOT YOUR JOB. 

24 NOT PURGED. 

25 NO JOBLOG ENTRY. 

26 GET PRIVILEGED MODE FAILURE. FATAL ERROR. 

27 GET USER MODE FAILURE. FATAL ERROR. 

28 JOB ALREADY CANCELED. 

29 CANCELED. 

30 CANCEL COMMAND WILL BE SENT TO HOST. 

31 INTERACTIVE TERMINAL REQUIRED FOR HOST CONSOLE COMMANDS. 
32 WARNING: HOST COMMAND CARD FOUND IN INPUT-NOT TRANSMITTED. 
33 ITEM 4 ONLY DISPLAYED FOR MANAGER. 

34 DISPLAY COMMAND WILL BE SENT TO HOST. 

35 FREE ENTRIES NOW EXIST. 

36 OLD JOBS IN THIS FILE. 

37 OLD JOBS PURGED THUS FAR. 

38 JOBS ARE IN THE JOB LOG. VERIFY PURGE WITH "YES" 

39 COMPLETELY PURGED OF ALL JOB ENTRIES. 

40 IS OFFLINE. HOST CONSOLE COMMAND CAN'T BE SENT. 

41 NOT ALTERED 

42 NO SPOOL FILE FOUND. 

43 SPOOL FILE DELETED. 

44 SPOOL FILE NOT IN READY STATE. UNABLE TO DELETE. 


46 MISSING RIGHT PARENTHESIS 
47 MANAGER CAPABILITY REQUIRED FOR THIS COMMAND 
48 "NOTRANSLATE" REQUIRED 
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Table 6-6, DSN/MRJE Message Catalog (continued) 


READER SPECIFIED TWICE. 

INVALID COMMAND 

INVALID HOSTID. MUST BE ALPHANUMERIC, <=8 CHARS 
PRINT SPECIFIED TWICE 

PUNCH SPECIFIED TWICE 

INVALID HOST SYSTEM 

INPUT MUST BE NUMERIC 

DIGITS ARE THE MAX ALLOWED FOR THIS NUMBER 
FORMS SPECIFIED TWICE 


DIGIT OR SPECIAL CHARACTER REQUIRED. 

LOGICAL DEVICE NUMBER OR DEVICE CLASS REQUIRED 

INVALID DEVICE CLASS SPECIFICATION 

NO CLOSING QUOTE ON DEVICE CLASS NAME 

INVALID FILE EQUATION SPECIFICATION. NAME MUST BE LESS THAN OR 


EQUAL TO 7 CHARACTERS. PLEASE CONSULT YOUR SYSTEM ADMINISTRATOR 
FOR MORE DETAIL. 


64 


INVALID SUBMIT PARAMETER 
INVALID ACTUAL FILE DESIGNATOR 
IS THE MAX LEVEL OF NAMES IN THIS ACTUAL FILE DESIGNATOR 
EMBEDDED BLANKS NOT ALLOWED IN QUALIFIED NAME 
IS THE VALID RANGE FOR THIS PARAMETER. 
"ALL" OR “OLDJOBS" ARE ONLY VALID PURGE PARAMETERS. 
“BS" OR "CS" OR "DS" REQUIRED. 
(CURRENT CMD CHAR) MUST BE FIRST CHAR IN USER HOST CMD. 
COMMA OR NUMBER REQUIRED 
ONLY 3 PARAMETERS ARE ALLOWED 
NUMERIC PARAMETER EXPECTED 
DAYS, HOURS, MINS CAN'T ALL BE ZERO 
HOSTNAME MUST START WITH SAME CHAR AS HOSTID 


INVALID PARAMETER FOR DISPLAY COMMAND 

“EBCDIC" OR “EBCDIK" REQUIRED 

ITEM NUMBER REQUIRED 

SSTDIN, SSTDINX, SOLDPASS ARE ONLY SYSTEM INPUT FILES ALLOWED 
NOTRANSLATE CAN'T BE SPECIFIED FOR SSTDIN/SSTDINX 
EXTRANEOUS INFORMATION AFTER VALID ITEM 

INVALID JOBNAME--TOO LONG 

INVALID SPECIAL CHARACTER 

COMMA OR SLASH REQUIRED TO SEPARATE PARAMETERS. 

FILE NAME, DEVICE CLASS, OR LOGICAL DEVICE NUMBER REQUIRED 
INPUT FILE NAME(S) REQUIRED 

NO BLANKS ALLOWED IN FORMAL FILE DESIGNATOR 

MAXIMUM OF 5 INPUT FILES ALLOWED 

INVALID KEYWORD 

PARAMETERS REQUIRED 

NO PARAMETERS ALLOWED 

IS THE MAXIMUM NUMBER OF CHARACTERS FOR THIS PARAMETER. 
INVALID OCTAL NUMBER 
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Table 6-6, DSN/MRJE Message Catalog (continued) 


IS THE ONLY VALID CONSOLE COMMAND. 


97 COMMA REQUIRED TO SEPARATE PARAMETERS 


98 

99 

100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 


"YES" OR “NO"“ REQUIRED 


IS AN INVALID PSEUDO LINE MONITOR DEVICE. FATAL ERROR. 
THIS ITEM NOT DYNAMICALLY CONFIGURABLE", 2; 
STANDARD INPUT FILE CAN'T BE OPENED. FATAL ERROR. 


CAN'T BE WRITTEN 
CAN'T BE CLOSED. FATAL ERROR. 
YOU MUST LOG ON MANAGER.SYS TO CREATE/PURGE CONFIG FILES. 
VALID RESPONSE MUST BE GIVEN 
CAN'T BE WRITTEN TO HOST READER 
CAN'T BE READ 
DIRECTORY FULL. NO FURTHER JOBS CAN BE SUBMITTED. 
CONFIGURATION FILE SET CANNOT BE ACCESSED. 
IS NOT YOUR JOB. 
NO NEW FILES CREATED. 
CONTINUATION LINE EXPECTED 
¢ OUTPUT FILE DOES NOT EXIST 
NO FILE DESIGNATOR ON ##FD CARD. 
CTRANSLATE FAILED 
CAN'T BE OPENED. 
READER CANNOT BE CLOSED 
NO JOB CARD FOUND. 
CAN'T BE POSTED 
END OF FILE ON S$STDINX. FURTHER INPUT IMPOSSIBLE. FATAL ERROR 
##FD CARDS NOT PERMITTED IN LEVEL 2 FILE 
NO JOBLOG ENTRY. 
CAN'T BE CANCELED. 
IS OFFLINE. JOB CAN'T BE CANCELED AT HOST. 
HOST CONSOLE COMMAND CAN'T BE WRITTEN. 
HOST CONSOLE CAN'T BE OPENED. 
UNABLE TO CLOSE SSTDINX. HOST CONSOLE COMMANDS CAN'T BE SENT. 
STANDARD INPUT FILE CAN'T BE OPENED FOR NOWAIT I/O. 
CONTROL-Y IS THE ONLY VALID INPUT DURING HOST COMMAND PROCESS 


BUT NOT IN JOBLOG. FATAL ERROR. 
JOB CAN'T BE CANCELED AT HOST FOR NON-INTERACTIVE USER. 
NOT PURGED. 

DIRECTORY/JOBLOG UPDATE CAN'T BE COMPLETED. FATAL ERROR. 
CAN'T BE CANCELED DUE TO A PREVIOUS 3000 SYSTEM FAILURE 
*** TTEM NOT USED WITH THIS HOST SYSTEM. 

HOST BUSY. CONSOLE COMMAND NOT SENT 


DSN/MRJE Message Catalog 


Table 6-6, DSN/MRJE Message Catalog (continued) 





SSET 3 MESSEAGE 1 TO 62 FOR HELP FACILITY 
1 SLUBMIT] infilel [(NE,T])] ...e.eeeeeeeee CL, infileS5 [(N[,1T])]] 
[; RLeaderEADER]=pseudo reader] [:; PRCINTJ=printfile [(N)J] 
C; PUCLNCH]=punchfile [(N)] C; FLORMS]=formfile [(N)]J] 
Submit a job or several jobs for transmission. Parameters are: 
(N) = NOTRANSLATION from ASCII to EBCDIC for infiles, or 
NOTRANSLATION from EBCDIC to ASCII for print file, 
punch file or formsfile. 
(T) = only first job card is recognized. 
MRJE manager capability required. 
Infile = 5 infiles may be specified. 
Print, punch or forms~file = may be either a device 
number device class, a unqualified actual file 
designator or a formal file designator. Note:the formal 
file designator must follow an exclamation mark and must 
be defined by a system administrator. 
2 DLISPLAY] {H[oSsT], J[OBLOG] {job#, jobname, joblist}, O[LDJOBS] “~ 
SCTATUS], CCONFIG] {item#, itemlist} 
Display job and system information 


DIRECTORY = list the contents of the job directory 

HOST = list the current host machine 

JOBLOG = information about jobs 

OLDJOBS = display canceled or time-out jobs 

STATUS = display the status of the current host line 
CONFIG = list the contents of the configuration file 





3 CCANCEL] [J[OBS]] {job#, jobname, joblist} 
Cancel one or more jobs and note the event in the job log file 


JOBS = optional parameter 
job# = number MRJE/3000 assigned to a job at submission time 
jobname = the name on a JOB card in an input file 


joblist = list job names and/or job numbers 
4 EXIT. COMMAND IS USED TO EXIT THE SUBSYSTEM. 
5 ALLTER] {item#, itemlist}. 


You must be an MRJE/3000 manager to use this command. on 
Specifies items in the configuration file are to be changed. 
item# = number assigned an entry in the configuration file. 


itemlist = a list of item numbers. 
6 P[URGE] {O[LDJOBS], A[LL]}. 
You must be an MRJE/3000 manager to use this command. 
Purges entries from a job log file. 
Oldjobs = purge entries for cancelled and timed-out jobs 
7 HLOST] Fost idl 
Select a particular host machine to be the current host machine 
8 NCEW] [Lhostid]. 
You must log on Manager.sys to use this command. 
Creates or recreates the configuration, joblog and directory 
files for a given host machine. 
hostid = used in a multi environments. Hostid can have up to 
eight alphanumeric characters. If several machines 
are defined, each hostid has a unique first characte 
9 Commands are: Alter, Cancel, Display, Host, New, Purge, Submit ips 
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Please type HELP <<command>> for the syntax of the <<command>> 



































APPENDIX 


CONFIGURATION FILE CONTENTS 


This appendix describes the contents of the DSN/MRJE configura- 
tion file. 


SUMMARY OF CONFIGURATION FILE ENTRIES 


In Table A-1, the following information is provided for each con- 
figuration file entry: 


ENTRY NUMBER (or “Item Number") AND DESCRIPTION.  DSN/MRJE 
accesses entries in the file by number. 


ENTRY/TYPE--the literal entry or the character type allowed 
for each entry. 


Literal entries appear in UPPER CASE letters 


n numeric (acceptable range of values is shown in table) 
an = alphanumeric 
sp = special (non-alphanumeric) 


* = numeric value of LDN (Logical Device Number); or 


alphanumeric value, enclosed in quotes, of DC (Device 
Class); for example, “OUTFILE"; or 


alphanumeric characters and slashes or periods, indi- 
cating an AFD (Actual File Designator) 


an exclamation mark followed by an seven character 
alphanumeric formal file designator, indicating pre- 
defined routing. 


ASCII BYTES—--the maximum number of characters that can be 
entered. 


DEFAULT VALUE provided by DSN/MRJE. When there is more’ than 
one value, the values are labeled as to Job Entry Subsystem. 
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NOTES--— 


1 


The ALTER command will not alter this entry. To change 
it, you have to re-build the configuration file (use NEW 
command). 


This entry is not displayed to DSN/MRJE Users. 


The first character of the User host console command 
must be identical to entry number 7. DSN/MRJE automat- 
ically alters this when entry number 7 is altered. 


This entry will be automatically changed whenever Item 
5--Job Entry Subsystem--is changed. The new value will 
be the default value for the new Subsystem. 


= 
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Following Table A-1 is a textual description of each configura- 
tion file item. 





Table A-1. DSN/MRJE Configuration File Entries 


ENTRY NUMBER AND DESCRIPTION ENTRY/ ASCII DEFAULT 











TYPE BYTES VALUE 
1. Host machine ID an 8 (none) 1 
2. Pseudo console n 3 (none) 
(logical device number) 0-999 
3. Pseudo line monitor n 3 (none) 
(logical device number) 0-999 
4. Signon card image an, sp 80 (none) 2 
5. Job Entry Subsystem on HASP, 4 (none) 
host JES2, 
JES3 or 
ASP 
6. User host console an 10 (none) 3 
command (s) 
7. Host console command n or sp 1 S (HASP) 4 
character S$ (JES2) 
* (JES3) 
* (ASP) 
8. Number of lines to n 3 10 (HASP) 4 
check for print banner 0-999 60 (JES2) 
a 60 (JES3) 
; 60 (ASP) 
9. Number of cards to check n 3 1 4 
for punch banner 0-999 
10. For HASP and JES2--column n 3 33 (HASP) 4 
where host-assigned ‘job 6-129 19 (JES2) 


number begins in the 
print banner 


For JES3 and ASP--width of n 3 13 (JES3) 4 
a block letter in the 6-129 13 (ASP) 
print banner 
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Table A-1. DSN/MRJE Configuration File Entries (continued) 
ENTRY NUMBER AND DESCRIPTION ENTRY/ ASCII DEFAULT NOTES ig 
TYPE BYTES VALUE 

11. Column where job name n 3 79 (HASP) 4,5 
begins in print banner 0-124 25 (JES2) 
(Not used by JES3 or ASP) 

12. Column where host-assigned n 2 44 (HASP) 4 
job number begins in the 1-76 44 (JES2) 
punch banner 21 (JES3) 

21 (ASP) 

13. Column where job name n 2 O (HASP) 4,6 

begins in punch banner 0-72 O (JES2) 
35 (ASP) 

14. For HASP and: JES2--column oon 3 10 (HASP) 4 
where "SETUP" or "LOAD" 1-120 21 (JES2) 
begins in special forms 
console message 
For JES3--column where n 3 18 (JES3) 
"JOB NAME" begins in 1-120 
special forms console 
message 
For ASP--column where n 3 16 (ASP) 
"JOB" begins in special 1-120 
forms console message 

15. Column where "JOB" n 2 11 (HASP) 4 
begins in console "job 1-99 10 (JES2) 
received" message 18 (JES3) 

16 (ASP) 

16. Column where job name n 2 35 (HASP) 4 
begins in console "job 1-99 28 (JES2) 
received" message | 30 (JES3) 

28 (ASP) 

17. Column where "ON" begins n 2 20 (HASP) 4 
in console "job received" 1-99 37 (JES2) 
message (not used by JES3 
or ASP) 

18. Maximum number of job log n 4 100 1 
file entries 25-1000 

19. Default device for input * 10 “MRDR1" 


to DSN/MRJE (LDN or DC) 





ENTRY NUMBER AND DESCRIPTION 


20. 


21. 


22+ 


23. 


24. 


25. 


26. 


27. 


28. 


29. 


30. 


3l. 


Default device for printer 
output from DSN/MRJE (LDN, 


DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


dis- 
1 (LDN, 


dis- 
2 (LDN, 


dis- 
3 (LDN, 


dis- 
4 (LDN, 


dis- 
5 (LDN, 


dis- 
6 (LDN, 


dis- 
7 (LDN, 


Default device for punch 


output from DSN/MRJE (LDN, 


DC, or AFD) 


Unsolicited punch dis- 


position, punch 1 


DC, or AFD) 


(LDN, 


Unsolicited punch dis- 


position, punch 2 
DC, or AFD) 


Unsolicited punch 
position, punch 3 
DC, or AFD) 


(LDN, 


dis- 
(LDN, 


ENTRY/ 


TYPE 


Configuration File Contents 


ASCII 


BYTES 


10 


26 


26 


26 


26 


26 


26 


26 


10 


26 


26 


26 


DEFAULT 


VALUE 


a LP | 


$8 LP 08 


%t TP | 


Th] LP 88 


st LP se 


90 LP 00 


T LP ee 


10 LP ee 


te LP oe 


ce LP a 


st LP a8 


98 LP 8 


DSN/MRJE. Configuration File Entries (continued) 


NOTES 
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Table A-1. DSN/MRJE Configuration File Entries (continued) 





ENTRY NUMBER AND DESCRIPTION ASCII DEFAULT NOTES 


BYTES VALUE 











32. Unsolicited punch dis- © 26 "LP" 
position, punch 4 (LDN, 
DC, or AFD) 
33. Unsolicited punch dis- . 26 "LP" 
position, punch 5 (LDN, 
DC, or AFD) 
34. Unsolicited punch dis- * 26 "LP" 
position, punch 6 (LDN, 
DC, or AFD) 
35. Unsolicited punch dis- : 26 "LP" ‘ 
position, punch 7 (LDN, | 
DC, or AFD) 
36. DSN/MRJE output process BS, CS 1 cs 
priority DS, or ES fl 
37. Number of characters to. n 1 8 
test in job name 0-8 
38. Translation type EBCDIC 1 EBCDIC 
or or 
EBCDIK EBCDIK 
39. Host system phone number n 16 (none ) 
40. Time communications line (no user 6 (none) 1 
opened (set by DSN/MRJE input ) 
when MRJECONTROL START 
executes ) 
41. Time communications line (no user 7 (none) 1 
closed (set by DSN/MRJE input ) 
when :MRJECONTROL SIGNOFF 
or KILL executes) 
42, Maximum time job remains n 6 1/0/0 
active in job log after 
transmittal (days,hrs,min) 
43. Host buffer size (bytes) n 5 400 


100-2000 
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TEXTUAL DESCRIPTION OF CONFIGURATION FILE ENTRIES 


1. 


Host machine ID: This name identifies the host for which this 
configuration file is being built. DSN/MRJE users will 
access the host machine through DSN/MRJE by using this name 
or the first character of this name. 


Pseudo console: The logical device number of the DSN/MRJE 
pseudo console. (See “Configuring MPE to Include DSN/MRJE", 
in Appendix D.) 


Pseudo line monitor: The logical device number of the first 
line monitor configured in MPE for this communications line. 
(See "Configuring MPE to Include DSN/MRJE", page D-11.) 


Signon card image: An exact image of the card sent from the 
DSN/MRJE workstation to the remote host system to identify 
the workstation. The format of this card is specified by 
remote system personnel and typically begins with "/*SIGNON" 
or “LOGON". 


Job Entry Subsystem on host: Specifies the name of the job 
Entry Subsystem in use at the remote host site. This entry 
implicitly defines the format of the host cancel and display 
commands, the format of the signoff card image, and the for- 
mat of the a host console commands that can be sent through a 
job stream. The format definitions are as follows: 


HASP JES2 JES3/ASP 
cancel $CJUnnnn,nnnn $CJnnnn,P *F,J=(nnnn),C 
display $DJnnnn $DJnnnn *I,J=(nnnn) 
Signoff /*SIGNOFF / *SIGNOFF / *SIGNOFF 
command /*s /*s /** 


This entry also implicitly defines defaults for entries 7 
through 17 in the configuration file. 


Note that entry 6, User host console command, is not affected 
by this entry. 


User host console command: This entry specifies the char- 
acters that can be typed by a User and transmitted to the 
host system as a host system console command. If the host 
Job Entry Subsystem is either HASP or JES2 and a dollar sign 
($) is entered here, any command beginning with "S$" may be 
issued by the User. For ASP and JES3, if an asterisk is en- 


tered here, the User may issue any command beginning with 
a 
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Te 


10. 


ll. 


12. 


13. 


Host console command character: This is the first character 
of all host console commands. If it is altered, item 6 is 
automatically changed so that the new command character is 
inserted in the User's host command. Also changed are the 
host cancel and display commands and the host command image 


(e.g. /*§). 


Number of lines to check for print banner: When print output 
is returned to DSN/MRJE from a host system, DSN/MRJE must 
identify the data set and route it to the appropriate output 
device or file. Each output data set is separated from 
others by a banner page. This entry specifies how many lines 
to scan for the print banner or separator page. Scanning 
begins at the first line following the end of the previous 
data set. 


Number of cards to check for punch banner: When punch output 
is returned to DSN/MRJE from a host system, DSN/MRJE must 
identify the data set and route it to the appropriate output 
device or file. Each output data set is separated from 
others by a banner. This entry specifies how many cards to 
scan for the punch banner or separator card(s). Scanning 
begins with the first card following the end of the previous 
data set. 


For HASP and JES2--column where host-asigned job number 
begins in print banner: This entry specifies the column in a 
print banner in which printed of the number assigned to a job 
by the host is to begin. DSN/MRJE expects the host-assigned 
job number to follow the word "JOB" with one blank between 
"JOB" and the job number and with at least one nonalphanu- 
meric character following the job number. 


For JES3 and ASP--width of a block letter in the print 
banner: The block character usually is 12 or 13 characters 
wide. All letters are expected to be 12 characters tall. 


Column where job name begins in print banner: This entry 
specifies the column number in which the job name begins in a 
banner page. MRJE expects at least one blank following the 
job name. If you enter a zero, MRJE will not look for a job 
name. (Not used by JES3 or ASP.) 


Column where host-assigned job number begins in punch ban- 
ner: This item is identical to item 10 except it appears at 
the beginning of a host punch data set. 


Column where job name begins in punch banner: This item is 
identical to Item 1l except it appears at the beginning of a 
host punch data set. Also, if you enter a zero, MRJE will 
not look for a job name and will expect the job number to be 
in special code; non-zero indicates standard punch code. 
The following table shows the special codes and MRJE's 
interpretation of them. 














14. 


15. 


16. 


17. 
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special code special code MRJE 
(hex ) (graphic) interpretation 


6A | Blank 
70 O 


\O 

S| 
ROUODSeEWu. 
ow O~I OF U1 PB WD Ee 


For HASP and JES2--column where “SETUP” or “LOAD" begins in 
in a print record at the beginning of the data set: When the 
host system sends a "forms mount" message to a printer, DSN/ 
MRJE extracts the job number and special forms name from the 
message, beginning in the column where the word "SETUP" or 
“LOAD" appears. "Forms mount" messages with the word "LOAD" 
are used in HASP II, Version 3.1; “forms mount" messages with 
the word “SETUP" are used in HASP II, Version 4 (and later 
versions), and in JES2. 


For JES3--column where "JOB NAME" begins in special forms 
console message: DSN/MRJE locates the job name in the "forms 
mount" message and searches from there to the end for key- 
words associated with the form name and for remote device 
identification. 


ASP--column where "JOB" appears in special forms console mes- 
Sage: DSN/MRJE locates the word "JOB" in the "forms mount" 
message and searches from there to the end for keywords 
associated with the form name and for remote device identifi- 
cation. 


Column where "JOB" begins in console "job received" message: 
When a job is submitted to a host system, DSN/MRJE is sent a 
console message indicating the host-assigned job number. 
This entry specifies the column in which the word "JOB" 
begins in the message. DSN/MRJE expects’ the host-assigned 
job number to follow "JOB “ and for at least one blank to 
follow the job number. 


Column where job name begins in console "job received" mes- 
sage: This entry refers to the same message as entry 15, but 
specifies the column where the job name _ begins. DSN/MRJE 
expects at least one blank to follow the job name. 


Column where "ON" begins in console "job received" message: 
This entry refers to the same message as items 15 and 16, but 
specifies the column where the word "ON" begins. DSN/MRJE 
expects at least one blank to follow the word "ON". (This 
entry is not used by JES3 or ASP.) 
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18. Maximum number of job log file entries: A number in the 
range from 25 to 1000 that specifies the number of entries 
the job log file can accommodate. (See the NEW command in 
Section IV.) 


19. Default input device: The logical device number or device 
class name of the device DSN/MRJE will use, by default, to 
send jobs to the host system. (This is the spooled pseudo 
card reader refered to in Appendix D, "Part 3 -- DSN/MRJE 
Pseudo Device Configuration Dialog". ) 


20. Default print output device: The logical device number, de- 
vice class name, actual file designator, or pre-defined out- 
put routing designator (!fileid) identifying the file or de- 
vice that print output will be routed to if the user does not 
specify an output destination in the SUBMIT command. 


21. Unsolicited print disposition, printer 1: The logical device 
number, device class name, actual file designator, or pre- 
defined output routing designator (!fileid) identifying the 
device or file that print output on print stream 1 will be 
routed to if DSN/MRJE cannot recognize where the output 
should be sent. 


22-27. Unsolicited print disposition, printers 2-7: Same as entry 
21, except apply to output on print streams 2-7. 


28. Default punch output device: The logical device number, de- 
vice class name, actual file designator, or pre-defined out- 
put routing designator (!fileid) identifying the file or de- 
vice that print output will be routed to if the user does not 
specify an output destination in the SUBMIT command. 


29. Unsolicited punch disposition, punch 1: The logical device 
number, device class name, actual file designator, or pre- 
defined output routing designator (!fileid) identifying the 
file or device that punch output will be routed to if DSN/ 
MRJE cannot recognize where the output should be sent. 


30-35. Unsolicited punch disposition, punches 2-7: Same as 29, 
except apply to output on punch streams 2-7. 


36. DSN/MRJE output process priority: The output processes of 
DSN/MRJE handle all data sets received from the host. A DSN/ 
MRJE Manager may declare their collective output priority on 
the HP 3000 to be in the BS, CS, DS, or ES subqueue. (The 
MPE System Manager/System Supervisor Reference Manual dis- 
cusses processing priority.) A lower priority output 
processes loads MPE less than a higher one. The ES’ subqueue 
is recommended for 56Kb line speeds. 
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37. 


38. 


39. 


40. 


4l. 


42. 


43. 
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Number of characters to test in job name: Whenever DSN/MRJE 
receives a message or an output data set from the host sys- 
tem, it checks the job name in the message or data. set 
against the entries in the job log file. The number of char- 
acters to be checked is set in this entry. Since some host 
installations append a job number to the job name, the 
DSN/MRJE Manager should be certain that the value entered 
here does not allow DSN/MRJE to read beyond the end of the 
job name. 


Translation type: Specifies whether the host job entry  sub- 
system expects data and job control information to be in 
EBCDIC or EBCDIK. DSN/MRJE will translate job input from 
ASCII before transmission to the host, and will translate job 
Output from the host to ASCII. 


Host system phone number: The phone number’ specified here 
will be displayed to the MPE console operator after the 
sMRJECONTROL START command has been issued. If the communica- 
tions line is a permanent connection, or auto-dialing is con- 
figured on an HP 30020B with a telephone number, no number 
need be entered here. 


Time communications line opened: If a time is shown, the line 
was last opened at that time (though not necessarily open 
now). This entry is automatically updated by DSN/MRJE, and 
the DSN/MRJE Manager cannot modify it. 


Time communications line closed: If a communications line was 
opened and subsequently closed, the time of closure is shown 
in this entry. This entry is automatically set by DSN/MRJE 
and cannot be altered by the DSN/MRJE Manager. 


Maximum time job remains active in job log after transmittal: 
The time specified (days,hours,minutes) determines how long 
it will be after a job was transmitted to the host before the 
job is reclassified as an “old job". (Refer to the discus-~ 
sion of the PURGE command in Section IV for a definition of 
“old jobs".) 


Host buffer size: The size of the host transmission buffer, 
in bytes. The buffer size is specified by host system per- 
sonnel. (Refer to Appendix E for discussion of host system 
configuration for DSN/MRJE. ) 
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INSTALLING DSN/MRJE 


The following procedure for installing DSN/MRJE is a suggested 
procedure, only. You may modify it to suit your needs. 


1) Obtain an Installation Tape (IT). 


2) Make certain that the necessary hardware has been installed 
and is operational. The hardware includes communications line 
controllers (INP's and/or SSLC's) and modems. 


3) Make certain that "CS" is configured into the system. If it 
isn't, then, during the configuration process described in 
step 5), add the necessary segments to the system Segmented 
Library (SL). Refer to Appendix D, Part 4, beginning at 
"SYSTEM SL CHANGES?" for the procedure. 


4) Restore the following files to group and account PUB.SYS with 
the MPE command RESTORE. 


MRJE MRJEMON MRJECAT 
MRJEOUT MRJELOGR 

IOMRJEO LTOMRJE 1 

LTOMCONS0O LTOMPNLPO 

IOMRDRO 


To run MRJE with an INP also restore IOINPO, and one of the 
following download files: 


for an HP 30010A restore CSDMRJEO; 
for an HP 30020A restore CSDMRJE1;> 
for an HP 30020B restore CSDMRJE2. 


To run MRJE with an SSLC also restore CSSBSCO and CSSMRJEO. 
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5) 


6) 


7) 


8) 


If 


Configure DSN/MRJE into the MPE I/O system: 


sFILE L;DEV=LP 
sFILE T:DEV=TAPE 
:SYSDUMP *T, *L 


Remember the Communications Controller (INP or SSLC) 
Download file for an INP: 

for an HP 30010A the file is CSDMRJEO; 

for an HP 30020A the file is CSDMRJE1; 

for an HP 30020B the file is CSDMRJE2. 
An Additional Driver for the SSLC, CSSMRJEO. 
The MRJE Drivers and their Pseudo Devices: 

IOMRJEO First line monitor; 

IOMRJE1 Second line monitor; 

IOMCONSO Pseudo Console; 

IOMPNLPO One for each pseudo printer and 
pseudo punch. Configure only 
as many as you expect to need; 

IOMRDRO One for each pseudo reader. 


Dump the new configuration to tape with all files from the 
group and account PUB.SYS. 


Cold load (use COLDSTART) the system using the tape created in 
Step 5). 


Update (UPDATE command) the tape described in Step 1). This 
completes the installation of DSN/MRJE. 


Issue the :MRJECONTROL CHECK command to make certain all the 
necessary DSN/MRJE software modules have been correctly 
installed. 


an 'UPDATE' has preceded the system a useable cold load tape 


has been created. 


Follow this sequence for trouble-free installation: 


First: BACK UP THE ENTIRE SYSTEM. 

Then: Restore files from an IT, mentioned in Step l. 
Update the system from the IT, mentioned in Step l. 
SYSDUMP with a new configuration. 


Finally: Coldstart the system from the tape created. 


























Installing DSN/MRJE on the HP 3000 
BUILDING DSN/MRJE CONFIGURATION FILES 


A separate configuration file must be built for each host 
machine. 


1) Refer to Appendix A for a description of the contents of the 
DSN/MRJE configuration file. 


2) Refer to the discussion of the DSN/MRJE NEW command in Section 
IV. You will use the NEW command to build your configuration 
files. Before issuing the command, examine the list of 
prompts associated with the command; get the information you 
will need to answer the prompts. 


3) Log on the HP 3000 as MANAGER.SYS 
4) Enter the :MRJE command. 
5) Enter the NEW command and respond to the prompts. 


6) Enter DISPLAY CONFIG and check the configuration. Pay partic- 
ular attention to Items 7-17, 37, 38, 42 and 43. DSN/MRJE 
assigns default values for these items. If any of the values 
1s not correct for your system, you may change it by using the 
DSN/MRJE ALTER command. The command is described in Section 
IV. 


BUILDING MRJE STREAM FILES 


A separate stream file must be built for each host system. The 
stream file is used whenever an MRJECONTROL START command is 
issued. The stream file must be named MRJESTRh, where h is’ the 
first letter of the host identification, and must be located in 
the PUB group of the SYS account. It may be created by any user 
with access to the PUB group of the SYS account. The structure 
of this file is the same as for any stream file. The contents of 
the stream file, MRJESTRh, are such that the monitor process will 
be executed. 


The stream file must contain the command RUN MRJEMON;INFO="h", 
where h is the first letter of the host identification, as the 
command preceding an EOJ. The stream file may contain other 
commands, such as for the specification of files for pre-defined 
output routing. The following is an example how to create a 
stream file: 
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>HELLO MANAGER.SYS 
HP3000 / MPE IV C.S2.08. WED, FEB 3, 1982, 2:56 PM 


s EDITOR 
HP32201A.7.10 EDIT/3000 WED, MAR 3, 1982, 2:56 PM 
(C) HEWLETT-PACKARD CO. 1981 


/a 

me MANAGER. SYS ;HPRI ; RESTART; TIME=? 

! COMMENT THIS JOB WILL ALLOW USERS TO ROUTE OUTPUT TO 
! COMMENT AN HP2680 WITH A SPECIFIC ENVIRONMENT. 

! COMMENT ALSO, THE STACK DUMP FACILITY IS ARMED TO 

| COMMENT OPERATE WHEN AN MRJEMON PROBLEM OCCURS. 


IFILE ELITE;DEV=LPS ;ENV=ELITE.ENV2680A.SYS 
I!FILE HOLDLP;DEV=LP,1 

!SETDUMP DB,ST 

!RUN MRJEMON; INFO="_ " 

1EOJ 


// 
/keep mrjestr 
/exit 


e 








Access to a stream file, such as the one created in the example 
above, should be limited to the creator through the use of the 
MPE command ALTSEC. This command is described in the "MPE Com- 
mands Reference Manual" (30000-90009). 


BUILDING HOST CONSOLE MESSAGE LOGGING FILES 


If you intend to log the console messages sent by the host, you 
will need to build a log file. Build a separate file for each 
host whose messages you want to log. 


Logging file records must contain fixed-length ASCII records at 
least 80 bytes long. The files must be named MRJEMSGh, where "h" 
is the first character of the host ID. For the default host, the 
name is MRJEMSG. Logging files must reside in PUB.SYS. Access 
to host console message logging files should be limited to their 
creator, MANAGER.SYS. Access may be limited through the use of 
the MPE command ALTSEC. This command is described in the "MPE 
Commands Reference Manual” (30000-90009). 


Refer to "Host Console Message Logging Facility" in Section IV 
for further information. 
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VERIFYING MRJE INSTALLATION 


A verification test is included in the DSN/MRJE software. The 


test activates DSN/MRJE and submits two jobs that produce 
printer, punch, and special form (C001) output. 


The verification test uses three files: 
@ TOOT192A 
e TO1T192A 
@ TO2T192A 


TOOT192A, when streamed, activates DSN/MRJE and submits the two 
jobs contained in the files TO1T192A and TO2T192A. Figure B-1 
lists the contents of the three files. These files were built 
for submission to a HASP system. They will probably have to be 
modified to suit individual host installations. The TOOT192A 
file was constructed so that it can be streamed by a user with 
read access to all files in the group and account 
HP32192.SUPPORT. To activate the test from another logon group 
and account, it will be necessary to modify this file, too. 


To run the verification test: 


1) Configure DSN/MRJE into the MPE system according to the 
instructions given above or in Appendix D of this manual. 


2) Use EDIT/3000, if necessary, to modify the test files ident- 
ified above. KEEP the files unnumbered. 


3) Use the NEW command to create the configuration, directory 
and job log files. 


4) Use the MPE :STREAM command to stream TOOT192A. 


5) Issue the :MRJECONTROL START command and make connection with 
the host system. 


The jobs will now be transmitted, processed by the host, and 
their output returned through DSN/MRJE. If these steps do not 
complete successfully, recheck TOOT192A and TOIT192A. If the 
files appear correct, recheck the configuration. 
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@® TOOT192A: 


!IJOB TOOT192A, FIELD.SUPPORT, HP32192;RESTART 
{MRJE 

SUBMIT TO1T192A 

DJ 

E 

!EOJ 


@ TOILT192A: 


//MRJEDEM5 JOB (1548,HPA),SAF,CLASS= 

//sl EXEC PGM=IEBGENER 

//SYSPRINT DD SYSOUT=A a“ 
//SYSUT1 DD * 

//SYSUT2 DD SYSOUT=A 

//SYSIN DD DUMMY 

##FD TO2T192A 


@ TO2T192A: 


//MRJEDEM2 JOB (1548,HPA),SFA, CLASS= 
//FORT EXEC FORTGCLG ~ 
//FORT.SYSPUNCH DD DUMMY 
//FORT.SYSIN DD * 
DO 100 I=1,5 
DO 100 J@#111111,1111110,111111 
K=J-111111 
100 WRITE(6,1000) K,K,K, K, K, K, K, K, K, Ky, K, K, K, K, K, K, K, K, K, K 
1000 FORMAT (1H , 2016) 


= “ 
* 


//GO.FTO6FOO] DD SYSOUT=(A, ,C0O01) 


Figure B-l1. DSN/MRJE Verification Jobs 














MODEM OPTIONS rc 


The tables on the following pages present Bell System and 
Hewlett-Packard modems that are compatible with DSN/MRJE. 
Included in the tables are recommended options (strappings) for 
the modems. New options have been added to Bell Model 201C; the 
modem is sold with these options as Model 201C-LID. If 201C 
modems are to be used, the local phone company should be con- 
sulted for local option requirements. It may also be necessary 
to contact the phone company regarding circuit standards, if HP 
shorthaul modems are going to be used. 


Modems that can be used for full-duplex transmission are Bell 
System Models 201C-L1D, 201C, 208A and 209A, and HP Model 37230A. 
Bell 201C and 208B, and HP 37230A can operate with DSN/MRJE in 
half-duplex mode. 


Modem Options 


Table C-1. Bell 201C-L1D Options and Recommendations 





Type of Modem: Bell System Type 201C-L1D Data Set 


Type of Line: Public telephone network (switched) 
Private leased line 


Full-duplex operation 


Transmission Rate: 2400 bits per second 





OPTION DESCRIPTION DESIG—- RECOMMENDATION 
NUMBER NATION 
Al Transmitter timing internal. Ye Al 
A2 Customer selected timing -_= 
1. External timing. - YD 
2. Slave (201C-L1D only). WI 
B3 Without new sync. YA B3 
B4 With new sync. YB 
C5 Switched carrier operation r 
1. 4-wire, 7 msec clear-to- | XA 4 
send delay. 7: 
2- 4-wire, O msec clear-to- XE 


send delay. 


C6 Continuous carrier operation C6: XC 
1. 4-wire, 7 msec clear-to- XB 
send delay. 
2. 4=-wire, O msec clear-to- ca 
send delay. XC “- 
D7 Continuous receiver Yo 


Bit clock aoa IN. 


D8 Continuous receiver YP D8 
Bit clock — OUT. 


EQ EIA interface pin 18 initiates Ys 
local analog loopback. 


E10 EIA interface pin 18 provides YT E10 
receive symbol clock. 
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‘_ Table C-1l Bell 201C-L1D Options and Recommendations (cont.) 


OPTION DESCRIPTION DESIG- RECOMMENDATION 
NUMBER NATION 


Factory furnished EIA inter- 
face and ground options. 


Customer selected EIA inter- F12: YM and YK 
face and ground options. 


Al Status of data set ready 
during local analog 
loopback —- ON. 

A2 Status of data set ready 
during local analog 
loopback - OFF. 

Bl Frame ground connected to 
signal ground. 

B2 Frame ground not connected 
to signal ground. 
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Table C-2. Bell 201C Options and Recommendations 





Type of Modem: Bell System Type 201C Data Set (also 
called DATAPHONE 2400) 


Type of Line: Public telephone network (switched) 
Private leased line 


Transmission Rate: 2400 bits per second 


OPTION DESCRIPTION RECOMMENDATION 
NUMBER 


Al Transmitter internally timed. Al (required) 


A2 Transmitter externally timed. 





B3 Without 801 Automatic Calling Unit. 

B4 With 801 Automatic Calling Unit. 

C5 EIA interface. C5 (required) 
C6 Contact interface. 


. D7 Without automatic answer. 





D8 With automatic answer. 
E9 Automatic answer permanently wired. 
E10 Automatic answer key-controlled. 


* If option D7 is selected, the E options have no meaning and | “) 
should be ignored. 
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Table C-3. Bell 208A Options and Recommendations 





Type of Modem: Bell System Type 208A Data Set (also 
called DATAPHONE 4800) 


Type of Line: Private leased line 
Transmission Rate: 4800 bits per second 
OPTION DESCRIPTION RECOMMENDATION 
NUMBER 
Transmitter internally timed. Al (required) 
Transmitter externally timed. 


Continuous carrier. 





Switched carrier. 

Switched REQUEST TO SEND. 
Continuous REQUEST TO SEND. 
One-second holdover used. 
One~second holdover not used. 


With new sync. 


Without new sync. E10 (required) 


CC ON when analog loop is present. Fll 


( ; CC OFF when analog loop is present. 








Modem Options 


Type of Modem: 


Type of Line: 


Table C-4. Bell 208B Options and Recommendations 


called DATAPHONE 4800) 


Transmission Rate: 4800 bits per second 


OPTION 
NUMBER 


DESCRIPTION 


Transmission internally timed. 


Transmission externally timed. 


Without 801 Automatic Calling Unit. 


With 801 Automatic Calling Unit 

CC OFF when analog loop is present. 
CC ON when analog loop is present. 
Without automatic answer. 

With automatic answer. 

Desk mounting. 


Rack or cabinet mounting. 


Bell System Type 208B Data Set (also 


Public telephone network (switched) 


RECOMMENDATION 


Al (required) 


D8 


Either 
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Table C-5. Bell 209A Options and Recommendations (1) 





Type of Modem: Bell System Type 209A Data Set (also 
called DATAPHONE 9600) 


Type of Line: Private leased line (3002-type, 4-wire) 


with Dl-type conditioning 


Transmission Rate: 9600 bits per second 





OPTION DESCRIPTION RECOMMENDATION 
Transmitter internally timed. Al (required) 
Transmitter externally timed. 


Data Set Ready interface lead ON for 
analog loopback mode. 





Data Set Ready interface lead OFF for 
analog loopback mode. 


Transmitter timing slaved by receiver. 


Transmitter timing not slaved by 
receiver. 





Elastic store option enabled (IN). 
Elastic store option disabled (OUT). 
Continuous carrier. 


Switched carrier. 





Switched REQUEST TO SEND. 
Continuous REQUEST TO SEND. F12 (2) 
Protective ground to signal ground. AA to BB 


With alternate voice. Either (3) 
Without alternate voice. 


If the 209A modem will be used in multiplexing applications 
the options shown do not apply. In this case, refer to 
Bell System Data Communications Technical Reference, Data 
Set 209A Interface Specifications (publication 41213). 


If option E10 is selected, the F options have no meaning 
and should be ignored. 





The data set normally is supplied without a hand set. 
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Table C-6. HP 37230A Strappings 
Type of Modem: Hewlett-Packard 37230A Short—haul 
Type of Line: 2- or 4-wire metallic. If leased from Bell, 


must conform to standards for intra-exchange lines 
in Bell System Technical Reference 41301. 


Transmission Rates: 9600, 4800, 2400 bits per second 





STRAP(S) 2-WIRE 4-WIRE 
Data Rate (A) 
2400 bps a a 
4800 bps b b 
9600 bps c Cc 
Test Links (B) b b 
(C) a a 
(N) a a 
Clock (D) b b 
(E) b b 
(Ss) b b 
Duplex (F) b (half). a (full) 
Carrier Select (H) b a 
Transmit Level (J) a a 
For conformity to BSTR 41301 
ats 2400 bps a a 
4800 bps b b 
9600 bps Cc Cc 
Receive Impedance (kK) Cc a 
Transmit Impedance, 
non-transmitting (L) a a 
Transmit Impedance, 
transmitting (M) a a 
Receive Level (P) 
2400 bps a a 
4800 bps b b 
9600 bps c Cc 
Signal Ground (Q) b b 
Remote Control of 
Digital Loopback 
(R) b a 
(x5) out in 
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Table C-7. Bell Dataphone II 2024A Modem Recommendation 





Type of Modem: Bell System Type DPII 2024A Data Set 










Type of Line: Private Leased Line; Public Telephone Network (Dial 
Back-Up) 


Transmission Rate: 2400 bits-per-second 
For Dataphone II Modems: 
o Only one control on each line. 

o C is usually the control computer site. 

o T is usually the remote computer, host, or terminal site. 
° 


C and T are for diagnostic purpose only. 


Transmission Rates: 2400 bits per second 











RECOMMENDATION 
COMPUTER TERMINAL 





DESCRIPTION 


Point-to-point control 






Point-to-point tributary, or 
extended point-to-point tributary 


B1 Internal timing (default) X x 










Continuous Carrier 
(Continuous RTS) 


C5 


ES Maximum Address - 16 x 







SA RS-232 Rise Time x »4 








Local 
Address 


Network 
Address 


* If rack mount level II, or level III, contact TELCO marketing 
for addressing assistance. 
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Table C-8. Bell Dataphone II 2048A Modem Recommendation 





Type of Modem: Bell System Type DPII 2048A Data Set 


Type of Line: Private Leased Line; Public Telephone Network (Dial 
Back-Up) 


Transmission Rate: 4800 bits-per-second 
RECOMMENDATION 
DESCRIPTION COMPUTER TERMINAL 
Point-to-point control 
Point-to-point tributary 
B1 Internal timing (default) 


C5 Continuous Carrier 
(Continuous RTS) 


E5 Maximum Address - 16 


SA RS-232 Rise Time 


Local 


Address om 


Network 
Address 





* If rack mount level II, or level III, contact TELCO marketing 
for addressing assistance. 
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Table C-9. Bell Dataphone II 2096A Modem Recommendation 
‘ Type of Modem: Bell System Type DPII 2096A Data Set 


Type of Line: Private Leased Line; Public Telephone Network (Dial 
Back-Up) 


Transmission Rate: 9600 bits-per-second 


RECOMMENDATION 
DESCRIPTION COMPUTER TERMINAL 


Point-to-point control 
Point-to-point tributary 


B1 Internal timing (default) 





C5 Continuous Carrier 
(Continuous RTS) 


E5 Maximum Address - 16 


SA RS-232 Rise Time 





Local 
Address 


Network 
Address 





* If rack mount level II, or level III, contact TELCO marketing 
for addressing assistance. 
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Table C-10. Bell Dataphone Digital Service (DDS), 


Data Service Unit (DSU) 


Type of Modem: Bell System 500B Type Data Service Unit (DSU) 


Type of Line: Bell Dataphone Digital Service (DDS) Channel 


Transmission Rate: 500B L1/2 2400 bits-per-second 
500B L1/3 4800 bits-per-second 
500B L1/4 9600 bits-per-second 
500B L1/5 56000 bits-per-second (56Kb) 


RECOMMENDATION 
DESCRIPTION COMPUTER TERMINAL 


Continuous Request-to-send 
(Default Option) 
Switched Request-to-send 


Signal Ground to Frame Ground 
(Default Option) 
Loop-Back Switch and Indicator 
Lamps on Front (Default) Customer Choice 
Loop-Back Switch and Indicator 
Lamps on Rear 


Circuit Assurance Installed 





NOTE 


You must use a 30221D (30221-60010) High Speed Synchronous Modem Cable 


(V.35) at 56Kb. 
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CONFIGURING MPE 
TO INCLUDE DSN/MRJE |[ D | 


This appendix describes how to configure DSN/MRJE into the MPE 
I/O system. 


CONFIGURATION REQUIREMENTS 


Each DSN/MRJE communications line to a host must. be configured 
separately into the MPE I/O system; the configurations must be 
compatible with the corresponding host system configurations. 


One communications controller must be configured into the MPE 1/0 
system for each of the DSN/MRJE communications lines to be oper- 
ated concurrently. Before configuration can begin, the control- 
ler(s) should be installed as described in their respective 
installation manuals. (See the Preface for a list of manuals.) 
During installation, note the hardware DRT setting for each con- 
troller, as the DRT numbers will be requested during MPE configu- 
ration. 


Listed below are the specifications for the devices that are con- 
figured into MPE for each DSN/MRJE communications line. Some of 
the devices are required for each line; others are optional. 


@ ONE COMMUNICATIONS CONTROLLER -- REQUIRED 


SSLC -OR- INP 
Device type: 18 Device type: 17 
Unit number: 0 Unit number: 0 
Driver: CSSBSCO Driver: IOINPO 
Driver changeable: YES Driver changeable: NO 
The secondary driver The download file for an 
is CSSMRJEO. HP 30010A is CSDMRJEO, for 


HP 30020A it is CSDMRJE1, and 
for HP 30020B it is CSDMRJE2. 


Each communications controller can be configured for use by 
other HP 3000 communications subsystems (such as DSN/DS) when 
it is not being used by DSN/MRJE. 


Guidelines for configuring multiple data communications sub- 
systems appear in Table D-1 at the end of this appendix. 


Configuring MPE 


Complete details of the configuration process are contained in 
the HP 3000 System Manager/System Supervisor Reference Manual. 


@ TWO PSEUDO LINE MONITORS -- TWO REQUIRED 
Device type: 22 
Device subtype: 0’ 
Unit number: O for driver IOMRJEO, 1 for IOMRJEI1 


@ ONE PSEUDO CONSOLE -- REQUIRED 
Device type: 22 
Device subtype: 0 
Unit number: 2 
Driver: IOMCONSO 


@ UP TO SEVEN PSEUDO LINE PRINTERS -- ONE REQUIRED 
Device type: 22 _ 
Device subtype: 0 : 
Unit numbers: 3 through 9; use "3" for first pseudo printer 
and don't skip numbers 
Drivers IOMPNLPO 
None of printers is spooled. 


e@ UP TO SEVEN PSEUDO CARD PUNCHES -~ NONE REQUIRED 
Device type: 22 
Device subtype: 0 om 
Unit numbers: 10 through 16; use "10" for the first Pseudo _ 
punch and don't skip numbers 
Driver: IOMPNLPO 
None of the pseudo punches is spooled. 


@e UP TO SEVEN PSEUDO CARD READERS -- ONE REQUIRED 
Device type: 22 
Device subtype: 0 
Unit numbers: 17 through 23; use "17" for first pseudo reader -_ 
and don't skip numbers 
Driver: IOMRDRO 
Only one pseudo card reader should initially be spooled. 


@® ONE ADDITIONAL DRIVER -- REQUIRED FOR EACH SSLC ONLY 
Drivers CSSMRJEO 
This driver is configured without logical device number or DRT 
number. 

















Configuring MPE 


Although DSN/MRJE provides for up to seven pseudo print- 
ers and seven pseudo punches, the number that can ac=- 
tually be configured is limited to the number of print- 
ers and punches configured on the host. Furthermore, 
configuring a large number of printers and/or punches 
causes more overhead for the HP 3000 system. CONF IGURE 
ONLY AS MANY PRINTERS AND PUNCHES AS YOU NEED. 


Since the DSN/MRJE pseudo devices are not really physical 
devices, they do not have hardware DRT numbers. When prompted 
for their DRT number during the configuration dialog, respond 
with a pound sign ‘#' followed by the ldev number of the control- 
ler for this line. This pound sign convention is illustrated in 
Figure D-l: SSLC1 is configured with logical device number "13"; 
the associated pseudo devices have all been configured with DRT 
numbers of "#13". 


If more than one communications controller is to be configured 
for use by DSN/MRJE, each controller must have a unique logical 
device number and its associated pseudo devices must have that 
number as their DRT number. 


Configuring MPE 














LOG DRT U CT SUB TERM REC OUTPUT MODE £ODRIVER DEVICE 
DEV # N HY TYPE TYPE SPEED WIDTH DEV NAME CLASSES 
# I AP 
T NE 
1 4 0 00 6 128 O *IOMDISC1 SPOOL 
DISC 
2 5 1 oOo 8 128 0 *ITOMDISC1 SPOOL 
DISC 
5 08s 0O 40 LP JA IOCDCDO CARD 
6 0 32 2 66 0 IOLPRTO LP 
7 0 240 128 0 IOTAPEO TAPE 
8 0 240 128 O IOTAPEO TAPE 
: 0 24 0 40 LP JA IOTAPEO JOBTAPE 
18 0170 0 9) IOINPO INP1 
20 0160 10 ?? 40 20 JAID IOTERMO TERM 
21 0160 10 +3=?? 40 21 JAID IOTERMO TERM 
22 0160 10 = 2? 40 22 JAID IOTERMO TERM 
40 0 22 0 40 0 IOMRJEO MRJE1 
41 0 22 0 40 9) IOMRJE1L MRJE2 
42 0 22 0 67 0 IOMCONSO MCONS 
43 0 22 0 67 0 IOMPNLPO MLP1 
44 0 22 0 67 0 IOMPNLPO MLP2 
45 0 22 0 67 0 IOMPNLPO MLP3 
46 0 22 0 67 0 IOMPNLPO MLP4 
47 0 22 0 67 0 IOMPNLPO MLP5 
48 0 22 0 67 O IOMPNLPO MLP6 
49 0 22 0 67 6) IOMPNLPO MLP7 
50 0 22 0 40 0 IOMPNLPO MPNCH1 
51 0 22 0 40 0 IOMPNLPO MPNCH2 
52 0 22 0 40 0 IOMPNLPO MPNCH3 
53 0 22 0 40 0 IOMPNLPO MPNCH4 
54 0 22 0 40 0 IOMPNLPO MPNCHS5 
55 0 22 0 40 0 IOMPNLPO MPNCH6 
56 0 22 0 40 9) LTOMPNLPO MPNCH7 
57 0 22 0 40 0 IOMRDRO MRDR1 
58 0 22 0 40 0 IOMRDRO MRDR2 
59 0 22 0 40 0 IOMRDRO MRDR3 
60 0 22 0 40 O IOMRDRO MRDR4 
61 0 22 0 40 0 IOMRDRO MRDR5 
62 0 22 0 40 0 IOMRDRO MRDR6 
63 0 22 0 40 0 “IOMRDRO MRDR7 
LDN PM PRT LCL TC RCV LCL CON MODE  # £TRANSMIT TM BUFFER D DRIVER 
MOD TMOUT TMOUT TMOUT SPEED SIZE C OPTIONS 
13 0 1 1 1 20 60 900 OIA 600 1 1024 Y O 
LDN CTRL PHONE NUMBER LIST LOCAL ID SEQUENCE 
LEN REMOTE ID SEQUENCE 
13 O 
ADDITIONAL CS DRIVERS 
047038-04 


Figure D-1. Example of MRJE Fully Configured into MPE I/O 
System. The communications interface is an _ INP. Configure 
only as many pseudo printers, punches, and readers as you will 
actually need; thes e pseudo devices consume system resources. 
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THE CONFIGURATION DIALOG 


The configuration dialog shown on the following pages has been 
edited to only those steps that pertain to DSN/MRJE. If the com- 
munication controllers are to be used by multiple communications 
subsystems, it will be necessary to refer also to Table D-1, SSLC 
and INP Configuration Summary, which appears at the end of this 
appendix. 


The configuration dialog below is divided into four parts. Parts 

1 and 4 apply whether an SSLC, INP, or DSN/MRJE pseudo device is 
being configured; the dialog is common to all three. Part 2 
describes the portion of the dialog that applies only to the SSLC 
and INP, while part 3 describes the dialog that applies only to 
DSN/MRJE pseudo devices. 


Where the word "return" appears in the dialog below, the user may 
press the RETURN key in response to the _ prompt. All user 
responses are underlined to distinguish them from HP 3000 
prompts. Some responses are shown as "YES" or "NO"; "Y" or "N" 
can be typed instead. 


Follow the steps stated in this section in "Installing DSN/MRJE". 
Then, to begin the configuration process, log onto the _ system, 
define the output device files, and initiate a SYSDUMP thus: 


sHELLO MANAGER. SYS 
HP3000 / MPE IV C.S2.08. WED, FEB 3, 1982, 2:56 PM 


sFILE T:DEV=TAPE 
:FILE L;DEV=LP 
:SYSDUMP *T, *L 


NOTE 


The file equations entered in conjunction with "SYSDUMP" 
must reflect the tape and line printer device class 
names actually configured on the HP 3000 system. (They 
might not be "TAPE" and "LP"!) 


Configuration Dialog - Part 1 


Part 1 -- Dialog Common to All Devices 


Step Dialog 
No. 
1 ANY CHANGES? YES 
2 SYSTEM ID = HP 32002A.v.uu.ff.? return 
3 MEMORY SIZE = xxx.? return 
4 I/O CONFIGURATION CHANGES? YES 
5 LIST I/O DEVICES? YES 
All I/O devices currently configured on the system are 
listed with the following column headings: 
LOG DEV Logical device number 
DRT # Hardware device address 
UNIT # Number of the device on its controller 
CHAN Always 0 for DSN/MRJE devices 
TYPE Device type: 
Always 17 for INP 
Always 18 for SSLC 
Always 22 for MRJE pseudo devices 
SUBTYPE Device subtype 
Always 0 for DSN/MRJE pseudo devices 
TERM TYPE Terminal type 
REC WIDTH Record width, decimal words 
OUTPUT DEV Device class name or device number 
MODE J = Accept jobs 
A = Accept data 
I = Interactive device 
D = Duplicative device 
S = Spooled device 
DRIVER NAME Driver name 
DEVICE CLASSES Class names assigned to the device 
6 LIST CS DEVICES? YES 


This prompt appears only if a communications device is 
currently configured in the system. The list is printed 
with the following column headings: 


LDN Logical device number 
PM Port mask 
Always O for DSN/MRJE devices 
PRT Protocol 
LCL MOD Local mode 
TC Transmission code 
RCV TMOUT Receive timeout 
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LCL TMOUT Local timeout 
CON TMOUT Connect timeout 
MODE O = Dial out 
I = Manual answer 
A = Automatic answer 
D = Dual speed 
H = Half speed 
C = Speed changeable 
TRANSMIT SPEED Transmission speed (characters/second) 
TM Transmission mode 
BUFFER SIZE Default buffer capacity, in words 
DC Driver changeable or not changeable 


DRIVER OPTIONS Driver options 


If the MPE system currently has a switched device, such 
as those that are connected through a dial-up telephone 
line, then additional information is printed in the 
following columns: 





LDN 

CTRL LEN 

PHONE NUMBER LIST 

LOCAL ID SEQUENCE 

REMOTE ID SEQUENCE 





HIGHEST DRT = xx.? return or nn > Xx. 


xx denotes the current highest hardware device number 
that can be assigned. Enter return if the number dis- 
played is large enough to include the devices that are 
being added. Otherwise, enter a higher DRT number. 


gen If an SSLC or INP is being configured, continue on to "Part 2 
-— SSLC and INP Dialog". I£ configuring a pseudo device, proceed 
to "Part 3 -- DSN/MRJE Pseudo Device Configuration Dialog". 
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Configuration Dialog - Part 2 


Part 2 -- SSLC and INP Dialog 
Step No. Dialog 


8 LOGICAL DEVICE #? 


Enter a unique number within the range 1 to maximum allowed by 
MPE. All devices are recognized by this number. This prompt 
is repeated later in the dialog to allow for configuration of 
more than one SSLC or INP. 


9 DRT #? 


Enter the hardware DRT number of the SSLC or INP. 
Enter "0" to cancel response to the previous prompt. 


10 UNIT #? 0 


An SSLC or INP should always be assigned unit number 0 
on its controller. 


11 SOFTWARE CHANNEL #? 0 
DSN/MRJE pseudo devices do not use software channels. 


12 TYPE? 17 Always 17 for the INP. 
18 Always 18 for the SSLC. 


13 SUBTYPE? 0 or 1 
0 Synchronous switched line with modem (telephone 
dial network). A subtype of zero enables "Data 
Terminal Ready" (DTR). 


1 Synchronous nonswitched line with modem (leased 
line). 


If an INP is being configured, the dialog will skip to 20. 


17 PROTOCOL? 
Enter an integer 1 to 255. 


18 LOCAL MODE? Enter any value within 
Enter an integer 1 to 15. the indicated ranges. 
DSN/MRJE will not use 
19 TRANSMISSION CODE? response. 


Enter an integer 1 to 63. 
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— RECEIVE TIMEOUT? return 
————_ DSN/MRJE will ignore response. 
21 LOCAL TIMEOUT? return 
a DSN/MRJE will ignore response. 
22 CONNECT TIMEOUT? return 


If the SSLC or INP was configured as subtype 0O in Step 13 
(because it is connected to a switched telephone line), the dia- 
log will continue with the next prompt. If the SSLC or INP was 
configured as subtype lin Step 13 (because it is connected 
with a non-switched leased line), the dialog will skip to Step 
29 


23 DIAL FACILITY? return or ldev 
~ Enter ldev if an HP 30030B, connecting to a Bell 801C auto- 


dialing unit and using a special auto-dialing cable (HP30221G), 
is installed, then calls will be dialed automatically. 


NOTE 


The ldev, the same value as entered in Step 8, must be 








~ entered here to indicate that automatic dialing of calls 
( may occur. This feature is supported for an INP 30020B 
‘ connected to a Bell 801C Automatic Calling unit with 


an HP 30221G cable. 


24 ANSWER FACILITY? YES or return 


Reply YES if ldev is specified in Step 23 
and an HP 30020B is configured, and will 
be used for auto-dialing. Otherwise, 
reply return. 





25 AUTOMATIC ANSWER? YES or return 


Reply YES if ldev is specified in Step 23 
and an HP 30020B is configured, and will 
be used for auto-dialing. Otherwise, 
reply return. 





26 DUAL SPEED? 


YES Local modem is dual speed (European models only). 
NO Local modem is single speed. 





Configuration Dialog - Part 2 


After a "NO" response to Step 26, the dialog skips the next step. 


27 


28 


29 


30 


HALF SPEED? (For European models only) 


YES Modem operates at half speed. 
NO Modem operates at full speed. 


After a response to this prompt, the dialog skips 
the next step. 


SPEED CHANGEABLE? 


Enter YES or NO. However, the response is ignored for 
modems that provide internal clocking signals. 


TRANSMISSION SPEED? 


Enter the line transmission speed, expressed as char- 
acters per second. 


Bits per second Characters per Second 





Specified transmission speed is ignored for modems with internal 
clocking signals. So, modems of different speeds may be used 
without reconfiguring the MPE. You must use a 30221D (30221- 


60010) cable at 56Kb, 7000 cps. See also Appendix C. 
TRANSMISSION MODE? 


QO Full Duplex 
1 Half Duplex 


Configure the SSLC or INP to operate in Full Duplex (0) if 
communications will take place over one of the following: 


@ A leased four-wire point-to-point line. 
e A dial network with two lines (four-wire). 
e A dial network with Wide Band Service. 


Configure the SSLC or INP to operate in Half Duplex (1) if 
communications are over a dial network with a single-line 
(two-wire). 


July 1983 D-10 





Configuration Dialog — Part 2 





31 PREFERRED BUFFER SIZE? 1024 ) 
DSN/MRJE ignores the response. 
32 DRIVER CHANGEABLE? YES SSLC only. 
NO INP only. 
33 DRIVER OPTIONS? 0 
34 DRIVER NAME? IOINPO INP 


CSSBSCO SSLC 
NOTE 


For autodial support on an HP30020B the download file is 
CSDBSC2. 





Steps 44 through 47 apply to SSLC's or INP's that use a synchron- 

ous switched telephone line (type 17, subtype 0 for INP; type 18, 

subtype 0 for SSLC). For SSLC's or INP's configured as subtype 1 

(synchronous nonswitched leased line), the dialog skips to Step 
om 48. 





44 PHONELIST? return, YES, or NO 
A YES will cause the next Step 45 to be executed. 


45 PHONE NUMBER? 
A string of numbers and hyphens not to exceed 20 
characters. 





46 LOCAL ID SEQUENCE? return 

DSN/MRJE ignores the response. 
47 REMOTE ID SEQUENCE? return 

DSN/MRJE ignores the response. 
48 DEVICE CLASSES? return 


DSN/MRJE ignores the response. 


The dialog returns to Step 8 to allow configuration of another 
SSLC or INP or configuration of the pseudo devices. If all de- 
vices have been defined, press RETURN in response to the LOGICAL 
DEVICE#? prompt and proceed to "Part 4 -=- Dialog Common to All 
Devices". 
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Part 3 -- DSN/MRJE Pseudo Device Configuration Dialog 
8 LOGICAL DEVICE #? -_ 


Enter a unique number within the range 1 to maximum allowed by 
MPE. All devices are recognized by this number. This prompt 

is repeated later in the dialog to allow for configuration of 

more than one SSLC or INP. 


9 DRT #? 


Enter a pound symbol (#) followed by a number identical 
to the logical device number of the INP or SSLC for 
which this pseudo device is being configured. (Refer 
to “CONFIGURATION REQUIREMENTS" at the beginning of 
this appendix. ) 


LO UNIT#? 


Pseudo device unit numbers must be assigned as follows: 


UNIT NUMBER DRIVER NAME PSEUDO DEVICES 


(1) IOMRJEO First line monitor. 























IOMRJE1 Second line monitor. 

IOMCONSO Pseudo console. om 
IOMPNLPO First pseudo printer. 
TOMPNLPO Additional pseudo 








printers. 



















IOMPNLPO Pseudo punches. 
IOMRDRO First pseudo reader. 
18 - 23 (2) IOMRDRO Additional pseudo 





punches. 






(1) = Device required. 
= Must use unit numbers in ascending order (lowest 
first). 





11 SOFTWARE CHANNEL #? 0 
DSN/MRJE devices do not use software channels. 


12 TYPE? 22 All pseudo devices are type 22. 
13 SUBTYPE? 0 All pseudo devices are subtype 0. 
34 RECORD WIDTH? 


40 Pseudo line monitor, card reader, card punch. 
67 Pseudo line printer and pseudo console. 
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35 OUTPUT DEVICE? 0 

36 ACCEPT JOBS/SESSIONS? NO 

37 ACCEPT DATA? NO 

38 INTERACTIVE? NO 

39 DUPLICATIVE? NO 

41 INITIALLY SPOOLED? YES or NO 
Spool first pseudo card reader, unit 17, as an output 
device. All other pseudo devices should not be 
spooled. 





NOTE 


Although the pseudo line printers should never be 
spooled, at least one actual MPE line printer should be 
spooled to handle DSN/MRJE output. The spooled printer 
should be specified as the default output device in 
entry number 20 of the DSN/MRJE configuration file that 
corresponds to this configuration. 





42 INPUT OR OUTPUT? OUTPUT 


This question is asked only if the response to the pre- 
ceding prompt was "YES". Note that even though the 
pseudo card reader is configured as an MPE spooled out- 
put device (because it is used to send data from MPE to 
another system), it should be specified as the default 
input device in entry number 19 of the DSN/MRJE config- 
uration file (because it is used for input to the 
host). 





43 DRIVER NAME? 
See the Unit Number in Step 10, above. 


ITOMRJEO First pseudo line monitor, unit 0. 

IOMRJE1 Second pseudo line monitor, unit l. 

IOMCONSO Pseudo console, unit 2. 

IOMPNLPO Pseudo line printers and card punches, 
4-16. 

IOMRDRO Pseudo card readers, units 18-23. 
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48 


DEVICE CLASSES? 


return 


name or 
return 


name 


DSN/MRJE does not use names for either line 

monitor, for the pseudo line printers, pseudo 
console, or pseudo punches. Names may be 
provided, however, for documentation within 
MPE. If names are used, they must be unique. 


Pseudo card readers: A unique name of up to 
eight alphanumeric characters in length, or 
return. 


For the SPOOLED pseudo card reader only, the 
following applies: The default class name of 
an DSN/MRJE spooled pseudo reader is "MRDR1". 
If another name is entered here, it will be 
necessary to alter (use ALTER command) entry 
number 19 of the DSN/MRJE configuration file 
corresponding to this configuration. 


The dialog now returns to Step 8 to allow configuration of addi- 
tional devices. 
the RETURN key in response to the LOGICAL DEVICE#? prompt and 
continue with "Part 4 -- Dialog Common to All Devices". 


If all 1/0 devices have been configured, press 
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Part 4 -- Dialog Common to All Devices 


51 MAX # OF OPEN SPOOLFILES = xx.? return 
52 LIST I/O DEVICES? YES 

53 LIST CS DEVICES? YES 

54 CLASS CHANGES? return 

66 LIST I/O DEVICES? return 


The prompt in Step 67 will be issued only if a communications 
device is currently configured in the system, or if additional 
drivers exist. 





67 ADDITIONAL DRIVER CHANGES? YES for SSLC, NO for INP. 
68 LIST ADDITIONAL DRIVERS? return 
69 DELETE DRIVERS? return 
o 71 ADD DRIVERS? YES for SSLC only. 
72 DRIVER NAME? CSSMRJEO for SSLC only. 
72 DRIVER NAME? return 
73 LIST ADDITIONAL DRIVERS? YES 
4 I/O CONFIGURATION CHANGES? return 
74 SYSTEM TABLE CHANGES? return 





The IOQ and ICS may need to be increased. Contact 
Hewlett-Packard. 


92 MISC CONFIGURATION CHANGES? return 


108 LOGGING CHANGES? return 


115 DISC ALLOCATION CHANGES? return 
129 SCHEDULING CHANGES? return 

130 SEGMENT LIMIT CHANGES? return 
137 SYSTEM PROGRAM CHANGES? return 
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139 


140 
141 
143 
145 


146 


148 


SYSTEM SL CHANGES? YES or return 


A "YES" response assumes this is the first communica- 
tions controller to be configured into the system. If 
the system already has an SSLC or INP configured, re- 
spond "NO" and skip to step 12. 


LIST LIBRARY? NO_ 

DELETE SEGMENT? NO 

REPLACE SEGMENT? NO 

ADD SEGMENT? NO 

ENTER SEGMENT NAME, USLFILE NAME [,S/C/P]? 


?2?COMSYS1, UO00U131A.HP30131.SUPPORT,S 
?2COMSYS 2, UOOUL31A.HP30131.SUPPORT,S 
?2COMSYS3, U00U131A.HP30131.SUPPORT,S 
2COMSYS4, U00U131A.HP30131.SUPPORT,S 
?COMSYS5, U00U131A.HP30131.SUPPORT,S 
?2CSUTILTY, U01U131A.HP30131.SUPPORT,S 
?BSCLCM, U03U131A.HP30131.SUPPORT,S 
?BSCSLCPO, U04U131A.HP30131.SUPPORT,S 
?DVRSSLC, U05U131A.HP30131.SUPPORT,S 
?return 


























ENTER DUMP DATE? 


8) Copies the entire system: MPE, the current 
accounting structure, and all files. This is 
appropriate with files @.PUB.SYS, as indica- 
ted in Step 149. 


return Copies the modified MPE. When this copy is 
used to COLDSTART the system, the accounting 
structure and all files remain intact. 


mm/dd/yy Where mm/dd/yy is some date in the future. 
Copies the modified MPE and the current 
accounting, but no files. 


mm/dd/yy Where mm/dd/yy is usually the date of the 
most recent system backup. Copies the modi- 
fied MPE, the current accounting structure, 
and any files that were changed on or since 
the specified date. 
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0 Copies the entire system (MPE, the current 
accounting structure, and all files). 


149 ENTER DUMP FILE SUBSETS? 


Enter return, a file name, or a series of file names (for 
example, @.PUB.SYS). Return is equivalent of @.@.@. 


150 LIST FILES DUMPED? NO 


151 The system operator must now use the =REPLY command to 
assign the magnetic tape device the SYSDUMP files will be 
dumped to. 


After the SYSDUMP is complete, the tape produced should be used 
to COLDSTART the system. During COLDSTART, the old I/O device 
configuration is replaced with the new one from the SYSDUMP tape. 
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Table D-1. INP and SSLC Configuration Summary 


If several subsystems will use the INP or SSLC, it must be con-~- 
figured so as to be compatible for all. This table summarizes 
the configuration choices available for each subsystem when it is 


the SOLE user of the INP or SSLC. The user will need to select 
the choices that will permit his or her particular set of sub- 
systems to use the INP or SSLC. 





Step MPE Prompt and the Recommended Response 
No. for Each Data Communications Subsystem 


UNIT #? O 
SOFTWARE CHANNEL #? 0 
TYPE? 


17 INP 
18 SSLC 


SUBTYPE? 


Synchronous, switched line with a modem 
Synchronous, nonswitched line with a modem 
Synchronous hardwired line 

Asynchronous hardwired line 


Jnafolelo 


or 1 DSN/DS, DSN/RJE, DSN/MRJE 
1, 3 or 7 DSN/MTS 
(DSN/IMF) 


8 
9 
i 


PROTOCOL? 1 
LOCAL MODE? 
Local is multipoint control station or primary 
contention station. 
2 Local is secondary contention station. 
or 2 DSN/DS, DSN/RJE 


1 
1 7 DSN/MTS and DSN/IMF 
DSN/MRJE overrides this option 
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Table D-1. INP and SSLC Configuration Summary (continued) 





MPE Prompt and the Recommended Response 


for Each Data Communications Subsystem 





19 TRANSMISSION CODE? 
1 Automatic code sensing 
2 ASCII 
3  EBCDIC 
1, 2, or 3 DSN/DS or DSN/RJE 
DSN/MRJE, DSN/MTS, and DSN/IMF over- 
ride the response. 
20 RECEIVE TIMEOUT? (default = 20) 





O = 32000 DSN/DS, DSN/RJE, DSN/MTS, and 
or return DSN/IMF 
DSN/MRJE overrides response. 





21 LOCAL TIMEOUT? (default = 60) 
O = 32000 DSN/DS, DSN/RJE, DSN/MTS, and 
or return DSN/IMF 





DSN/MRJE overrides response. 
22 CONNECT TIMEOUT? (default=900) 
300 Recommended for DSN/DS, DSN/RJE, DSN/MTS. 
900+ Recommended for DSN/IMF. 
DSN/MRJE overrides response. 


23 DIAL FACILITY? YES, NO, ldev, or return. 





DSN/DS, DSN/RJE, and DSN/MTS use response. 
DSN/MRJE with auto-dial uses the ldev response. 
DSN/MRJE without auto-dial and DSN/IMF don't use 
response. 


NOTE 


The ldev, the same value as entered in Step 8, must be 
entered here to indicate that automatic dialing of calls 
may occur. This feature is supported for an INP 30020B 
connected to a Bell 801C Automatic Calling unit, with 
an HP 30221G cable. 
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Table D-1. INP and SSLC Configuration Summary (continued) 





Step MPE Prompt and the Recommended Response 
No. for Each Data Communications Subsystem 


2h ANSWER FACILITY? YES, or return 


DSN/DS, DSN/RJE, and DSN/MTS use response. DSN/MRJE uses this 
if an ldev isin Step 23, and only when an auto-dialer is 
connected to an HP 30020B INP with an HP 30221G cable. 


DSN/IMF does not use response. 
25 AUTOMATIC ANSWER? YES or return 


Reply YES if ldev is specified in Step 23 and an HP 
30020B is configured, and will be used for autodialing. 
Otherwise, reply return. 


26 DUAL SPEED? 


YES or NO DSN/DS, DSN/RJE, DSN/MRJE - 
YES for European modems, only. 
NO DSN/MTS 
DSN/IMF doesn’t use response. 


27 HALF-SPEED? YES or NO 





DSN/DS, DSN/RJE, DSN/MRJE use response. 
DSN/MTS AND DSN/IMF don’t use response. 


28 SPEED CHANGEABLE? YES or NO 
Response overridden for modems with internal clocking. 
29 TRANSMISSION SPEED? 


Line transmission speed in characters per second: 
250, 300, 600, 900, 1200, 7000 See Note. 


NOTE 


You must use a DDS Modem and a 30221D (30221-60010) cable with a V.35 
hood at a speed of 7000 characters per second. See also Appendix C. 


DSN/IMF overrides response. 
30 TRANSMISSION MODE? 


QO Full duplex 
1 Half duplex 
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Step 
No. 


31 


32 


33 
43 


44 


46 
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Table D-1. INP and SSLC Configuration Summary (continued) 


MPE Prompt and the Recommended Response 
for Each Data Communications Subsystem 


PREFERRED BUFFER SIZE? OC = 4095 
1024 words maximum for INP, 4095 maximum for SSLC. 


1024 Recommended for DSN/DS. 

500 Recommended for DSN/MTS. 

~~ DSN/MRJE, DSN/RJE and DSN/IMF override response. 
DRIVER CHANGEABLE? 


YES DSN/MRJE with SSLC, DSN/MTS with SSLC. 
NO All other subsystems and configurations. 


DRIVER OPTIONS? 0 
DRIVER NAME? 


CSSBSCO SSLC 
LOINPO INP 


PHONE LIST? YES or NO 


DSN/DS, DSN/RJE, and DSN/MTS use response. 
DSN/MRJE without auto-dialing and DSN/IMF override 
response. 


A phonelist is used only for auto-dialing and when con- 
nected to an HP 30020B INP. The telephone number in 
item 39 of a DSN/MRJE configuration file (MRJECONh) 
always over-rides the phonelist. When autodialing is 
specified for an HP 30020B, and when there is no tele- 
phone number in item 39 of the configuration file, the 
phonelist is used. (In all other situations the phone- 
list will not be used for DSN/MRJE. ) 


DSN/MRJE will read only the first number in the  phone- 
list. That number will be the DSN/MRJE default number. 


An HP 30020B must be connected with ae Bell solic 
auto-dialing unit using a special HP 30221G cable. 


A NO response causes the next step to be skipped. 
LOCAL ID SEQUENCE? id character string or return 


DSN/DS uses response. DSN/MTS, DSN/RJE, DSN/MRJE, and 
DSN/IMF do not use response. 


D-21 


Configuring MPE 


Table D-l1. INP and SSLC Configuration Summary (continued) 







MPE Prompt and the Recommended Response 
for Each Data Communications Subsystem 


47 REMOTE ID SEQUENCE? id character string or return 



















DSN/DS uses response. DSN/MTS, DSN/RJE, DSN/MRJE, and 
DSN/IMF do not use response. 


48 DEVICE CLASSES? 


classname or return DSN/DS, DSN/MRJE, DSN/MTS, 
DSN/IMF. 

RJLINE DSN/RJE. Additional names are 
optional; see DSN/RJE Refer- 
ence manual, Section III for 
discussion of #RJLINE subsystem 

command. 


The same class name may not be used for both the INP and 
the SSIC. 





ADDITIONAL DRIVER CHANGES? 


YES DSN/MRJE with SSLC and DSN/MTS with SSLC only. 
NO All other subsystems and configurations. 










ADD DRIVERS? YES or NO 
DRIVER NAME? 


CSSMRJEO DSN/MRJE with SSLC. 
CSSBSC1 DSN/MTS with SSLC. 


D-22 









CONFIGURING THE HOST SYSTEM FOR 
COMMUNICATIONWITHDSN/MRJE || £ | 








Follow the guidelines in this appendix when configuring the host 
system for communication with DSN/MRJE. 


CONFIGURING A HASP SYSTEM 


For a HASP system, specify: 


@ Terminal type: System/360, model 25 or higher. 





@ Line printer width: 132 characters or less. 
@ Console support: YES 
e Transparency: YES 


@ Communications line: 
a. Full or half duplex 
b. Speed: less than or equal to 9600 bits per second for 
communication through an SSLC. Less than or equal 
to 56000 bits per second for communication through 
an INP. 
c. EBCDIC and transparent. 





e Multileaving buffer size: Not to exceed 2000 characters. A 
large buffer size will give you better performance when the 
communication line operates at 56Kb. 





e A standard forms name of "STD." in the standard forms para- 
meter, or use "STD." as the name of standard forms for both 
printers and punches. 


@ All other generation parameters should be specified consistent 
with practices at the host site. 


Make note of the value being configured for the number of print 
lines per page. This value should be used as entry number 8 in 
the DSN/MRJE configuration file for this host. 


NOTES 


Consult with host system operations when your communications 
line is configured at 56Kb. Also, configure two printer streams 
for better subsystem performance at this speed. 
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CONFIGURING A JES2 SYSTEM 


For a JES2 system, specify: 


Remote terminal type: S/360. 

The terminal should have: 

a. A console. 

b. A multileaving interface. 

c. The text transparency feature. 

For each remote printer configured at a remote terminal: 

a. Automatic forms mode. 

b. Automatically started printer. 

¢. No FCB support. 

d. Separator pages. 

e. Printer width: 132 characters or less. 

For each remote card punch configured at a remote terminal: 

a. Automatic forms mode. 

b. Automatically started punch. 

c. Separator cards. 

For each remote card reader configured at a remote terminal: 

Automatically started (hot) card reader. 

A standard forms name of "STD." in the standard forms param- 

eter or use "STD." as _ the name of standard forms for both 

printers and punches. 

Communication line: 

a. Full or half duplex 

b. Speed: less than or equal to 9600 bits per second for com- 
munication through an SSLC. Less than or equal to 56000 
bits per second for communicaton through an INP. 

c. EBCDIC and transparent. 

Multileaving buffer size: Not to exceed 2000 characters. A 

large buffer size will give you better performance when the 

communication line operates at 56Kb. 

All other generation parameters should be specified consistent 

with practices at the host site. 


Make note of the value being configured for the number of print 
lines per page. This value should be used as entry number 8 in 
the DSN/MRJE configuration file for this host. 


NOTES 


Consult with host system operations when your communications 


line is configured at 56Kb. Also, configure two printer streams 
for better subsystem performance at this speed. 
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Configuring the Host System for Communication 


CONFIGURING A JES3 OR ASP SYSTEM 


For a JES3 or ASP system, specify the following: 


Remote terminal type: 8S/360 

The terminal should have: 

a. A console. 

b. A multileaving interface. 

c. The text transparency feature. 

For each remote printer configured at a remote terminal: 

a. Automatically started printer. 

b. No FCB support. 

ec. Printer width of 132 characters or less. 

d. Separator pages. 

For each remote card punch configured at a remote terminal: 

a. Automatically started punch. 

b. Separator cards. 

For each remote card reader configured at a remote terminal: 
Automatically started (hot) card reader. 

A standard forms name of "STD." in the standard forms parame- 
ter, or use "STD." as the name of standard forms for both 
printers and punches. 

Communication line: 

a. Full or half duplex 


b. Speed: less than or equal to 9600 bits per second for 
communication through an SSLC. Less than or equal 
to 56000 bits per second for communication through an INP. 
ec. EBCDIC and transparent. 
Multileaving buffer size: Not to exceed 2000 characters. A 
large buffer size will give you better performance when the 
communication line operates at 56Kb. 
All other generation parameters should be specified consistent 
with practices at the host site. 


Make note of the value being configured for the number of print 
lines per page. This value should be used as entry number 8 in 
the DSN/MRJE configuration file for this host. 


NOTES 


Consult with host system operations when your communications 
line is configured at 56Kb. Also, configure two printer streams 
for better subsystem performance at this speed. 
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ASCII/EBCDIC CHARACTER TABLES 





ASCII 
Character 
A 
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040400 
041000 
041400 
042000 
042400 
043000 
043400 
044000 
044400 
045000 
045400 
046000 
046400 
047000 
047400 
050000 
050400 
051000 
051400 
052000 
052400 
053000 
053400 
054000 
054400 
055000 


060400 
061000 
061400 
062000 
062400 
063000 
063400 
064000 
064400 
065000 
065400 
066000 
066400 
067000 
067400 
070000 
070400 
071000 
071400 
072000 
072400 
073000 
073400 
074000 
074400 
075000 


030000 
030400 
031000 
031400 
032000 
032400 
033000 
033400 
034000 
034400 


000000 
000400 
001000 
001400 
002000 
002400 





Table F-l. 


First Character Second Character 
Octal Equivalent Octal Equivalent 


000101 
000102 
000103 
000104 
000105 
000106 
000107 
000110 
000111 
000112 
000113 
000114 
000115 
000116 
000117 
000120 
000121 
000122 
000123 
000124 
000125 
000126 
000127 
000130 
000131 
000132 





000141 
000142 
000143 
000144 
000145 
000146 
000147 
000150 
000151 
000152 
000153 
000154 
000155 
000156 
000157 
000160 
000161 
000162 
000163 
000164 
000165 
000166 
000167 


000170 - 


000171 
000172 


000060 
000061 
000062 
000063 
000064 
000065 
000066 
000067 
000070 
000071 





000000 


‘000001 


000002 
000003 
000004 
000005 
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ASCII Character Set 


ASCII First Character Second Character 
Character Octal Equivalent Octal Equivalent 


003000 
003400 
004000 
004400 
005000 
005400 
006000 
006400 
007000 
007400 
010000 
010400 
011000 
011400 
012000 
012400 
013000 
013400 
014000 
014400 
015000 
015400 
016000 
016400 
017000 
017400 
020000 
020400 
021000 
021400 
022000 
022400 
023000 
023400 
024000 
024400 
025000 
025400 
026000 
026400 
027000 
027400 
035000 
035400 
036000 
036400 
037000 
037400 
040000 
055400 
056000 
056400 
057000 
057400 
060000 
075400 
076000 
076400 
077000 
077400 


First Character 
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000006 
000007 
000010 
000011 
000012 
000013 
000014 
000015 
000016 
000017 
000020 
000021 
000022 
000023 
000024 
000025 
000026 
000027 
000030 
000031 
000032 
000033 
000034 
000035 
000036 
000037 
000040 
000041 
000042 
000043 
000044 
000045 
000046 
000047 
000050 
000051 
000052 
000053 
000054 
000055 
000056 
000057 
000072 
000073 
000074 
000075 
000076 
000077 
000100 
000133 
000134 
000135 
000136 
000137 
000140 
000173 
000174 
000175 
0001 76 
000177 


Second Character 


Table F-2. ASCII-EBCDIC-Hollerith Conversions 





HOW TO USE THIS TABLE 


The table is sorted by character code, each code being represented by its decimal, octal, and hexadecimal 
equivalent. 


Each row of the table gives the ASCII and EBCDIC meaning of the character code, the ASCII¢®EBCDIC 
conversion code, and the Hollerith representation (punched card code) for the ASCII character. 


The following examples describe several ways of using the table: 


Example 1: Suppose you want to determine the ASCII code for the $ character. Scan down the ASCII graphic column 
until you locate $, then look left on that row to find the character code — 36 (dec), 044 (oct), and 24 (hex). This is the 
code used by an ASCII device (terminal, printer, computer, etc.) to represent the $ character. Its Hollerith punched card 
code is 11-3-8. 


Example 2: The character code 5B (hex) is the EBCDIC code for what character? Also, when 5B is converted to ASCII 
(for example, by FCOPY with the EBCDICIN option), what is the octal character code? First, locate 5B in the hex 
character code column and move right on that row to the EBCDIC graphic which is $. The next column to the right 
gives the conversion to ASCII, 044. As a check, find 044 (oct) in the character code column, look right to the ASCII 
graphic column and note that $ converted to EBCDIC is 133 (oct) which equals 5B (hex). 





12-0-1-8-9 
12-1-9 
12-29 
12-3-9 


79 
0-5-8-9 
0-6-8-9 

0-7-8-9 


11-6-9 
12-5-9 
0-5-9 
12-3-8-9 


12-4-8-9 
12-5-8-9 
12-6-8-9 
12-7-8-9 


12-11-1-89 
11-1-9 
11-2-9 
11-3-9 


4-8-9 
5-8-9 
2-9 

0-6-9 


11-8-9 
11-1-8-9 
7-8-9 
0-7-9 


11-4-8-9 
11-5-8-9 
11-6-8-9 
11-7-8-9 


Blank 
12-7-8 
73 
3-8 


11-3-8 
0-4-8 
12 

5-8 


12-5-8 
11-5-8 
11-4-8 
12-6-8 
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Table F-2. ASCII-EBCDIC-Hollerith Conversions (continued) 






a ees 
to 
Cntl 
Dec Oct Hox it EBCDIC Zaid 
P (Oct) 
96 140 60 















































: 1-8 12-11-8-9 

97 141 61 12-0-1 ae 
98 142 62 12-0-2 - 
12-0-3 11-0-3-9 
















110-4-9 
4 

12-05 joes 
12-0-6 110-6-9 


12-0-7 11-0-7-9 











12-0-8 110-89 
12-0-9 0-1-8 
12-11-1 12-11-0 





12-11-0-1-9 


12-11-0-2-9 
12-11-0-3-9 
12-11-0-4-9 
12-11-0-5-9 


12-11-0-6-9 
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DSN/MRJE Subsystem Commands 


DSN/MRJE Product Number HP32192A 


Capability DSN/MRJE 
Requirements User Manager 
Account default OP * 
Group default default 
User default OP * 


* The user and account must be MANAGER.SYS to use both the NEW 
and the PURGE ALL commands. 


sMRJE 


Initiates the subsystem. 


For listing $STDLIST to an optional file, precede the command 
with a file equation whose formal designator is LISTING: 


sFILE LISTING ;:DEV=LP 
:MRJE 


With the use of the FILE statement above, all commands and most 
output generated by them will be sent to S$STDLIST and to device 
class LP. 


#Alter {item number} 
{item list} 


You must be a DSN/MRJE Manager to use this command. It specifies 
the items in the configuration file to be changed. 


item number The number assigned an entry in the configuration 
file. Range is 1 through 43. 


item list A comma-separated list of item numbers. 


#Cancel [Jobs] {job number} 
{job name} 
{job list} 


Cancels one or more jobs and notes the event in the joblog file. 
The DSN/MRJE manager can cancel any job, regardless of who sub- 
mits it. As a DSN/MRJE user you may cancel only those jobs you 
have submitted. 
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DSN/MRJE Subsystem Commands 





Jobs Optional parameter. 
job number The number DSN/MRJE assigns to a job when 
submitted. 
job name The name on a JOB card in an input file. 
job list A comma-separated list of job names and/or job 
numbers. 
#DispLlay Host 
#Display Joblog L,job number] 


[,job name Jj] 
[,job list J] 





#Display Oldjobs 
#Display Status 
#Display Config [,item number] 


[,item list ] 


Displays job and system information. 





Host Lists the current host system The host is referenced by 
SUBMIT, DISPLAY, ALTER, PURGE, and CANCEL commands until 
a HOST command selects another system. 


Joblog Displays information about jobs. If neither the job 
numeber, job name, nor a job lsit is specified, displays 
the entire job log file for the current host system. 
This is the default. A DSN/MRJE manager may display any 
job; users may display only those jobs’ they have 
submitted. 





Oldjobs Displays canceled or timed-out jobs. A timed-out job 
has been in the job log file longer than the limit 
established by item 42 of the configuration file. 


Config Lists the contents of the configuration file. If an 
item list is included, only those items are displayed. 


A DSN/MRJE manager may display the entire configuration 
File; users may display only selected items. 


exit 


Terminates DSN/MRJE and returns control to MPE. 
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DSN/MRJE Subsystem Commands 


#New CLhost identification] 


Creates or re-creates the configuration, job log, and directory 
files for the host identification specified. You will be prompt- 
ed to give information. You must log on as MANAGER.SYS to use 
this command. 


In a single-host environment, the host identification parameter 
need not be specified. 


Host ident- Needed only for multi-host environments. The host 

fication identification may contain eight alphanumeric 
characters. In a multi-host environment, the first 
character must be unique. 


After using this command you may ALTER items in the configuration 
file. 


#Purge {Oldjobs} 
{All } 


Purges entries from the job log file. 


Oldjobs Purges entries for cancelled and timed out jobs. See 
item 42 of the configuration file. You must be a DSN/ 
MRJE manager to use this command. 


#Host [host identification] 


Selects a particular host system to be the current host system. 
The host identified by this command is referenced by all subse=- 
quent commands of the subsystem. 


Host The name of a host machine that was configured by the 
ident- DSN/MRJE manager. This may be abbreviated to its first 
ifica- character. Omit this parameter to select the default 
tion host system. 


#<host system console command> 


Whenever a communications line is active, host system console 
commands may be issued interactively. They must begin with the 
character specified in item 7 of the configuration file. 
DSN/MRJE managers may issue only those host system console con- 
mands allowed to the remote station. DSN/MRJE users are addi- 
tionally restricted to host system console commands beginning 
with the string in item 6 of the configuration file. A host sys- 
tem console command will be refused if any other DSN/MRJE user or 
manager is already communicating interactively with the host sys- 
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DSN/MRJE Subsystem Commands 


tem; however, host console commands may be submitted as _ job 


input. An DSN/MRJE manager will retain interactive use of the 
host system console until a CONTROL-Y is issued. A DSN/MRJE user 
may enter only one host system console command at ae time. see 


also the JES2 commands in Section D of the Data Communications 
Handbook. 


#Submit Infilelf(NL,TJ)J] [ ... , InfileS5[{(NE,T])] J 
[;Reader=pseudo reader logical device number ] 


C[;PRint = print file [ (N) 7 
[:PUnch = punch file [ (N) 1 
[;Forms = forms file [ (N) 7] 


N The Notranslate parameter requests no translation for a_ file 
when its contents are transmitted or received. The default 
is to translate ASCII to EBCDIC for input files, and EBCDIC 
to ASCII for output files. 


T The Transparent transmission parameter requests that the 
first JOB card of an Infile be recognized, and that all 
subsequent JOB cards within that Infile be passed to the host 
system as data. DSN/MRJE Manager capability is required to 
use this option in the SUBMIT command. 


Infile Five infiles may be specified. They are 
transmitted in the sequence in which they appear in the 
SUBMIT command. An infile can be: 


@ An optionally qualified actual file designator. 

e A formal file designator equated to an actual file 
designator, a logical device number, a device 
class name, or one of these system files: SSTDIN, 
SSTDINX, or SOLDPASS. 


® A device class name of a real MPE input device, 
enclosed in quotation marks, for example "TAPE". 

@ One of these system files: S$STDIN, S$STDINX, or 
SOLDPASS. 

® A logical device number of a real MPE input 
device. 


pseudo Specifies a particular DSN/MRJE pseudo reader on _ which 
reader the jobs in the input file will be submitted. Pseudo 
reader can be: 


® The logical device number assigned to a DSN/MRJE 
pseudo reader. . 

é A pseudo reader device class name enclosed in quo- 
tation marks. The pseudo reader should have a 


unique device class name. 
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HP 3000 Console Operator's Summary 


If READER=parameter is omitted, then the default pseudo 
reader is identified in configuration file item 19. 


print These parameters specify where the results of processing 
file of a submitted job are to go. One of each can be speci- 
fied by: 
punch 
file ® The logical device number of an MPE output device. 
e An MPE device class name enclosed in quotation 
forms marks. 
file ® An unqualified actual file designator. 
® An exclamation mark, followed by a seven character 
file name, to indicate predefined routing. 
® A zero device, to indicate unsolicited output de- 


vice routing. 


The default output devices for print and punch files are 
in configuration file items 20 and 28. The default form 
file is the default print file. 


HP 3000 CONSOLE OPERATOR COMMAND SUMMARY 
:MRJECONTROL START[L,host id][;TRACE,ON,trace options] 


Used to open a communications line, initiate transmission over 
the line, and turn on the CS TRACE facility. Contact Hewlett- 
Packard to find out the most appropriate way to use the trace 
options. 


sMRJECONTROL SIGNOFF[L,host id] 


Used to close the communications line in an orderly fashion. 


:MRJECONTROL KILL[,host id] 


Used to close the communications line immediately and in an un- 
orderly fashion. 
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HP 3000 Console Operator's Summary 
sMRJECONTROL RETRIES, [host id],retry number 


Used to set a limit on the number of times DSN/MRJE will request 
re-transmission of a block of data not receivéd successfully from 
the host. 


sMRJECONTROL {TRACE,[host id],ON[trace options] } 
{TRACE, [host id], OFF } 


Used to activate and de-activate the CS TRACE facility. Contact 
Hewlett-Packard to find out the most appropriate way to use this 
command. 


trace options f,(ALLJI[,£[_mask][,[—numentries][,[WRAP][,file]]]J] 
file The name of a file where trace records are to be stored. 
This file must be built prior to execution of the com- 
mand. If this parameter is omitted, then its name will 


be MRJETRCh.PUB.SYS, where h is the first character of 
the host id. 


LISTING TRACE FILE CONTENTS 


The CS TRACE dump utility program CSDUMP.PUB.SYS can be used to 
format and print the contents of trace files generated by the 
trace facility. An example of the commands required to list the 
files to a line printer is: 


:sFILE CSTRACE=file name 
:FILE LIST;DEV=LP Device class "LP" must be configured. 
:RUN CSDUMP. PUB.SYS[,HEX] 





where "file name" is the name of the file specified in the conm- 
mand :MRJECONTROL TRACE (or, if no file name was specified, 
MRJETRCEh). The secondary entry point "HEX" may be used to pro- 
duce uninterpreted data in hexadecimal instead of octal based 
numbers. 
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HP 3000 Console Operator's Summary 
JOB INPUT 
A job stream is composed of MPE job control cards; HASP, JES2, 


JES3 or ASP job control cards; executable programs; and data. 


80-column card images are stored in one or more HP 3000 files. 
One card image constitutes one record ina file. 


Files that are merged to form a job stream can contain any number 
of separate jobs. 


Three levels of input files are permitted: 


® Infiles Named in a SUBMIT command 

® Level-one FD files. Named on ##FD card images in 
infiles. 

® Level-two FD files. Named on ##FD card images in 


level-one infiles. 


No “looping" between any input files is permitted. Infiles and 
FD files must constitute a valid job stream according to the host 
system requirements. 


FD files and infiles may contain they same kind of information 
and may be constructed in the same way. 


Five infiles are permitted in a SUBMIT command. An infile name 
may be: 


actual file designator, qualified or unqualified 
formal file designator 

device class name 

logical device number 


system file names: SSTDIN, SSTDINX, or SOLDPASS 


##FD file name [(NC[,TJ]) Ccomment] J] 
C(TCL,N)) 


File definition cards may appear in infiles and in level-one FD 
files to reference additional files. The ##FD card images are 
not transmitted. The "##FD" must occur in the first four  char- 
acters of the card image. 


file name The file designator can be: 
® Actual file designator, qualified or unqualified. 
@ Formal file designator. 
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HP 3000 Console Operator's Summary 


@ Device class name. 
® Logical device number. 
® System file name: $STDIN, SSTDINX, or SOLDPASS. 
N No translation requests that the FD file be submitted 
without translation. Refer to the SUBMIT command. 
T Transparent transmission requests that all JOB’ cards 


be passed to the host system as data. Refer to the 
submit command. 

comment Optional. If file name is either $STDIN or $STDINX the 
comment will be printed at your terminal before the 
DSN/MRJE message: ENTER INPUT ENDING WITH MRJEOD. It 
may always be used to identify the type of input 
expected. 


MRJEOD 


For infiles or FD files orginating from SSTDIN or SSTDINX, an 
"MRJEOD" in characters 1 through 6 acts as an end sentinel for 
data, and an end of file. This record is never transmitted. 


JOB OUTPUT 


Output can be routed to a disc file or to an output device by 
naming the output files in the SUBMIT command, or by specifying 
them in user defined routing and referencing them in the SUBMIT 
command. File record sizes are: 


Print file: 132 characters per record with CCTL 
Forms file: 132 characters per record with CCTL 
Punch file: 80 characters per record 


If a SUBMIT command names a disc file, build the file with suffi- 
cient extents allocated because DSN/MRJE will not allocate addi- 
tional ones as the need arises. The subsystem does inform the 
system operator when the file limits are exceeded. 


In the SUBMIT command, specify output files using one of the 
following: 


An unqualified actual file designator. 

The logical device number of an MPE output device. 

An MPE device class name. 

An exclamation mark, followed by an seven character file 
name, to indicate user predefined output routing. 
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HP 3000 Console Operator's Summary 


@ A zero character, to indicate unsolicited output 


Both print and special forms files must have 132 character’ re- 
cords with carriage control character specified, CCTL;REC=-132 
characteristics. 


CARRIAGE CONTROL 


When output is written to a disc file, a carriage control charac- 
ter prefixes line printer and special forms’ reords. DSN/MRJE 
translates the characters as follows: 


HOST SYSTEM CONTROL HP3000 CONTROL CODE 


Skip immediately n spaces, n<3. $101 (if necessary) 
$2nn (nn<3) 


Skip immediately to channel n, #101 (if necessary) 
n<13. $3nn (2<nn<12) or 
%61, for channel l. 


Space n lines after print, n<3. $100 (if necessary) 
$2nn (nn<3) 


Skip to channel n after print, %100 (if necessary) 
n<13. $3nn (2<nn<12) or 
$61, for channel 1 


Suppress space $53 
All other host system control Single space 
codes. 
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Configuration File Format 


SUMMARY OF CONFIGURATION FILE ENTRIES 


The following information is provided for each con- 
figuration file entry: 


ENTRY NUMBER (alternatively referred to as “Item Number") AND 
DESCRIPTION. DSN/MRJE accesses entries in the file by 
number. 


ENTRY/TYPE--the literal entry or the character type allowed 
for each entry. 


Literal entries appear in UPPER CASE letters 

n = numeric (acceptable range of values is shown in table) 
an = alphanumeric 

sp = special (non-alphanumeric) 

* = numeric value of LDN (Logical Device Number); or 


alphanumeric value, enclosed in quotes, of DC (Device 
Class); for example, "OUTFILE": or 


alphanumeric characters and slashes or periods, indi- 
cating an AFD (Actual File Designator) 


an exclamation mark followed by an seven character 
alphanumeric formal file designator, indicating pre- 
defined routing. 


ASCII BYTES--the maximum number of characters that can be 
entered. i 


DEFAULT VALUE provided by DSN/MRJE. When there is more’ than 
one value, the values are labeled as to Job Entry Subsystem. 


NOTES--— 
1 The ALTER command will not alter this entry. To change 


it, you have to re-build the configuration file (use NEW 
command). 


2 This entry is not displayed to DSN/MRJE Users. 
3 The first character of the User host console command 
must be identical to entry number 7. DSN/MRJE automat- 


ically alters the character when entry number 7 is 
altered. 
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Configuration File Format 


ENTRY NUMBER AND DESCRIPTION 


4. 


5. 


4 This 


The new value 


be the default value for the new Subsystem. 


DSN/MRJE Configuration File Entries 


Host machine ID 


Pseudo console 
(logical device number) 


Pseudo line monitor | 
(logical device number) 


Signon card image 


Job Entry Subsystem on 
host 


User host console 
command (s) 


Host console command 
character 


Number of lines to 
check for print banner 


Number of cards to check 
for punch banner 


ENTRY/ 
TYPE 


an 
0-999 


n 
0-999 
an, sp 
HASP, 
JES2, 
JES3 or 
ASP 


an 


n or sp 


0-999 


0-999 


ASCII 
BYTES 


DEFAULT 
VALUE 
8 (none) 
3 (none) 
3 (none) 
80 (none) 
4 (none) 
10 (none) 
1 S (HASP) 
S (JES2) 
* (JES3) 
* (ASP) 
3 10 (HASP) 
60 (JES2) 
60 (JES3) 
60 (ASP) 
3 1 
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entry will be automatically changed whenever Item 
5--Job Entry Subsystem--is changed. 


will 


NOTES 














DSN/MRJE Configuration 


ENTRY NUMBER AND DESCRIPTION 


10. 


ll. 


12. 


13. 


14. 


15. 


16. 


For HASP and JES2--column 
where host-assigned job 
number begins in the 
print banner 


For JES3 and ASP--width of 
a block letter in the 
print banner 


Column where job name 
begins in print banner 
(Not used by JES3 or ASP) 


Column where host-assigned 
job number begins in the 
punch banner 


Column where job name 
begins in punch banner 


For HASP and JES2--column 
where "SETUP" or “LOAD" 
begins in special forms 
console message 


For JES3--column where 
"JOB NAME" begins in 
special forms console 
message 


For ASP--column where 
"JOB" begins in special 
forms console message 


Column where “JOB" 
begins in console 
received" message 


"Job 


Column where job name 
begins in console “Job 
received" message 


Configuration File Format 


File Entries (continued) 


ENTRY/ 


TYPE 


6-129 


ASCII DEFAULT 
BYTES VALUE 
3 33 (HASP) 
19 (JES2) 
3 13 (JES3) 
13 (ASP) 
3 79 (HASP) 
25 (JES2) 
2 44 (HASP) 
44 (JES2) 
21 (JES3) 
21 (ASP) 
2 O (HASP) 
O (JES2) 
35 (ASP) 
3 10 (HASP) 
21 (JES2) 
3 18 (JES3) 
3 16 (ASP) 
2 11 (HASP) 
10 (JES2) 
18 (JES3) 
16 (ASP) 
2 35 (HASP) 
28 (JES2) 
30 (JES3) 
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Configuration File Format 


DSN/MRJE Configuration 


ENTRY NUMBER AND DESCRIPTION 


17. Column where "ON" begins 
in console "job received" 
message (not used by JES3 
or ASP) 

18. Maximum number of job log 
file entries 

19. Default device for input 
to DSN/MRJE (LDN or DC) 
20. Default device for printer 
output from DSN/MRJE (LDN, 


21. 


22. 


23. 


24. 


25. 


26. 


27. 


DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


Unsolicited print 
position, printer 
pc, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


Unsolicited print 
position, printer 
DC, or AFD) 


dis- 
1 (LDN, 


dis- 
2 (LDN, 


dis- 
3 (LDN, 


dis- 
4 (LDN, 


dis- 
5 (LDN, 


dis- 
6 (LDN, 


dis- 
7 (LDN, 


File Entries (continued) 


ENTRY/ ASCII DEFAULT NOTES 
TYPE BYTES VALUE 
n 2 20 (HASP) 4 
1-99 37 (JES2) 
n 4 100 1 
25-1000 
* 10 "MRDRI1" 
fe 10 "7p" 
s 26 "LP" 
26 "LP" 
* 26 "DLP" 
* 26 "Lp" 
% 26 "rp" 
* 26 "Lp" 
* 26 "Tp" 
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ENTRY NUMBER AND DESCRIPTION 


28. 


29. 


30. 


31. 


32. 


33. 


34. 


35. 


36. 


37. 


38. 


39. 


Configuration File Format 


DSN/MRJE Configuration File Entries (continued) 


Default device for punch 
output from DSN/MRJE (LDN, 


DC, or AFD) 


Unsolicited punch 
position, punch 1 
DC, or AFD) 


Unsolicited punch 
position, punch 2 
DC, or AFD) 


Unsolicited punch 
position, punch 3 
DC, or AFD) 


Unsolicited punch 
position, punch 4 
DC, or AFD) 


Unsolicited punch 
position, punch 5 
DC, or AFD) 


Unsolicited punch 
position, punch 6 
DC, or AFD) 


Unsolicited punch 
position, punch 7 
DC, or AFD) 


DSN/MRJE output process 


priority 


Number of characters to 


test in job name 


Translation type 


Host system phone number 


dis- 
(LDN, 


dis- 
(LDN, 


dis- 
(LDN, 


dis- 
(LDN, 


dis- 
(LDN, 


dis- 
(LDN, 


dis- 
(LDN, 


ENTRY / ASCII 
TYPE BYTES 
10 
# 26 
* 26 
% 26 
sd 26 
* 26 
" 26 
26 
BS, CS 1 
DS, or ES 
n 1 
0-8 
EBCDIC if 
or 
EBCDIK 
n 16 


DEFAULT 
VALUE 


NOTES 


"LP" 


"Tp" 


"Tp" 


ot LP" 


TY LP" 


"EP" 


08 LP" 


“LP" 


CS 


EBCDIC 
or 
EBCDIK 


(none ) 
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Configuring a HASP, JES2, JES3, or ASP System 


DSN/MRJE Configuration File Entries (continued) 


ENTRY NUMBER AND DESCRIPTION 


40. Time communications line 
opened (set by DSN/MRJE 
when MRJECONTROL START 
executes ) 


41. Time communications line 
closed (set by DSN/MRJE 
when :MRJECONTROL SIGNOFF 
or KILL executes) 


42. Maximum time job remains 
active in job log after 
transmittal (days,hrs,min) 


43. Host buffer size (bytes) 


CONFIGURING A HASP SYSTEM 


For a HASP system, specify: 


Console support: YES 
Transparency: YES 
Communications line: 

a. Full or half duplex 


ENTRY/ ASCII DEFAULT NOTES 
TYPE BYTES VALUE 


(no user 6 (none) 1 
input ) 
(no user 7 (none) 1 
input ) 
n 6 1/0/0 
n 5 400 
100-2000 


Terminal type: System/360, model 25 or higher. 
Line printer width: 132 characters or less. 


b. Speed: less than or equal to 9600 bits per second for com- 


munication through an SSLC. 


Less than or equal to 56000 


bits per second for communication through an INP. 


Consult with host system operations. 


ce. EBCDIC and transparent. 
e Multileaving buffer size: 


Not to exceed 2000 characters. A 


large buffer size will give you better performance when the 
communication line operates at 56Kb. 
e Configuring two printer streams improves subsystem performance 


at 56Kb. 


e A standard forms name of “STD.” 


in the standard forms para- 


meter, or use "STD." as the name of standard forms for both 


printers and punches. 
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Configuring a HASP, JES2, JES3, or ASP System 


All other generation parameters should be specified consistent 
with practices at the host site. 


Note the number of lines per page. This value should be used as 
entry number 8 in the MRJE/3000 configuration file for this host. 


CONFIGURING A JES2 SYSTEM 


For a JES2 system, specify: 


Remote terminal type: $/360. 


The terminal should have: 

a. A console. 

b. A multileaving interface. 

c. The text transparency feature. 


For each remote printer configured at a remote terminal: 
Automatic forms mode. 

Automatically started printer. 

No FCB support. 

separator pages. 

Printer width: 132 characters or less. 


om oF ®& 


For each remote card punch configured at a remote terminal: 
Automatic forms mode. 

Automatically started punch. 

c. Separator cards. 


o 9 


For each remote card reader configured at a remote terminal: 
a. Automatically started (hot) card reader. 


A standard forms name of "STD." in the standard forms param- 
eter or use "STD." as the name of standard forms for both 
printers and punches. 


Communication line: 

a. Full or half duplex 

b. Speed: less than or equal to 9600 bits per second for com- 
munication through an SSLC. Less than or equal to 56000 
bits per second for communicaton through an INP. Consult 


with host system operations on 56Kb speed. 


c. EBCDIC and transparent. 
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Configuring a HASP, JES2, JES3, or ASP System 


Multileaving buffer size: Not to exceed 2000 characters. A 
large buffer size will give you better performance at 56Kb. 
Configuring two printer streams improves subsystem performance 
at 56Kb. 


All other generation parameters should be specified consistent 
with practices at the host site. 


Make note of the value being configured for the number of print 
lines per page. This value should be used as entry number 8 in 
the MRJE/3000 configuration file for this host. 


CONFIGURING A JES3 OR ASP SYSTEM 


For a JES3 or ASP system, specify the following: 


Remote terminal type: $/360 


The terminal should have: 

a. A console. 

b. A multileaving interface. 

c. The text transparency feature. 


For each remote printer configured at a remote terminal: 
a. Automatically started printer. 

b. No FCB support. 

ec. Printer width of 132 characters or less. 

d. Separator pages. 


For each remote card punch configured at a remote terminal: 
a. Automatically started punch. 
b. Separator cards. 


For each remote card reader configured at a remote terminal: 
a. Automatically started (hot) card reader. 


A standard forms name of "STD." in the standard forms parame- 
ter, or use "STD." as _ the name of standard forms for both 
printers and punches. 


Communication line: 
a. Full or half duplex 


b. Speed: less than or equal to 9600 bits per second for com- 
munication through an SSLC. Less than or equal to 56000 
bits per second for communication through an INP. Consult 


with host system operations on 56Kb speed. 


EBCDIC and transparent. 


Q 


July °83 Appendix G (Communications Handbook Sec. E)-18 








Configuring a HASP, JES2, JES3, or ASP System 


@ Multileaving buffer size not to exceed 2000 characters. A 
large buffer size will give you better performance when the 
communication line operates at 56Kb. 





e Configuring two printer streams improves susbsystem 
performance at 56Kb. 


@ All other generation parameters should be specified consistent 
With practices at the host site. 


Make note of the value being configured for the number of print 
lines per page. This value should be used as entry number 8 in 
the MRJE/3000 configuration file for this host. 
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DSN/MRJE Messages 


DSN/MRJE MESSAGES 


These messages are unique to DSN/MRJE activity: 


User messages -- These are printed on a user’s output 
device. These are listed alphabetically, starting on 
G-21 ° 

MRJECONTROL distributed console messages -- These are 


sent to the terminal of the user who issued the 
MRJECONTROL command. These are listed by Command Inter- 
preter Error (CIERR) number, starting on G-4O. 


Console operator messages -- These are sent to the sys- 
tem console. These are listed alphabetically, starting 
on G-43. 


In these messages, those that report an error or a failure also 
include the cause and instructions for corrective action. In 
cases where a message gives information only, and no error or 
failure occured, only the message and its meaning are given. 
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DSN/MRJE User Messages 


DSN/MRJE User Messages 


* "ALL" OR “OLDJOBS" ARE ONLY VALID PURGE PARAMETERS. 
A PURGE parameter other than ALL or OLDJOBS was 
entered. Re-enter PURGE command with no parameter 
(for OLDJOBS) or with "ALL" or "OLDJOBS". 


* "BS" OR "CS" OR "DS" REQUIRED. 
| BS, CS, or DS are the only valid values for output 
process priority in the configuration file. 


jobname CANCELED. 
job# 
Specified job has been canceled as requested. 


* jobname CAN'T BE CANCELED. 
job# 
Named job cannot be canceled because of an error in 
writing to or reading from a job log file. Retry the 
CANCEL. 


SCJ host#,host# CANCEL COMMAND WILL BE SENT TO HOST. 

SCJ host#, P 
When an interactive User/Manager cancels a job which 
has been transmitted to the host and the host is 
on-line, DSN/MRJE automatically sends the appropriate 
host cancel command and prints the host response. 


* COMMA OR NUMBER REQUIRED. 
Comma or number is required. 


* COMMA OR SLASH REQUIRED TO SEPARATE PARAMETERS. 
Comma or slash required to separate parameters in 
"“Joblist" or “itemlist”. 


* COMMA REQUIRED TG SEPARATE PARAMETERS. 
Comma is required to separate positional parameters, 
DAYS, HOURS, MINUTES. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages (continued) 


* DEFAULT HOST CONFIGURATION FILE SET CANNOT BE ACCESSED. 
HOST hostname 
Named host configuration file cannot be accessed 
because of an open or read error. Determine the 
reason for the I/O failure from the MPE file error 
number. 


* CONTINUATION LINE EXPECTED. 
When an ampersand (&) is entered at the end of a_ line 
in a SUBMIT command, DSN/MRJE expects the following 
line(s) to be a continuation of the command. Re-enter 
the entire SUBMIT command with continuation line(s) as 
required. 


* CONTROL-Y IS THE ONLY VALID INPUT DURING HOST COMMAND 


PROCESSING. 
A User may only enter Control-Y during host console 
command processing. (Control-Y halts output.) Any 


other input causes this error message and returns the 
# prompt. If all output has not been received, 
re-enter the host console command. 


* filename RECORD m CTRANSLATE FAILED. 
An error occurred while translating a SUBMIT input 
file from ASCII to EBCDIC (or EBCDIK, depending on the 
translation type). This is an internal software 
failure. Contact Hewlett-Packard. 


DAYS, HOURS, MINS CAN'T BE ZERO. 
The maximum time a job remains in the job log file 
after transmission cannot be zero. 


DEFAULT HOST ASSUMED. 
If no host name is given in a HOST or NEW command, 
DSN/MRJE assumes the default host is desired. 


* DIGIT OR SPECIAL CHARACTER REQUIRED. 


Host system character must be a digit or a special 
character. Re-enter command. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages 


DSN/MRJE User Messages (continued) 


* n DIGITS ARE THE MAX ALLOWED FOR THIS NUMBER. 


A number with too many digits has been entered. 
Re-enter command with no more than n digits. 


SDJ host# DISPLAY COMMAND WILL BE SENT TO HOST. 


When an interactive User/Manager displays a job that 
has been transmitted to the host and the host is 
online, DSN/MRJE automatically sends the appropriate 
host display command and prints the host response. 


jobname: DUPLICATE JOBNAMES IN JOBLOG. CANCEL REFUSED. A 
DISPLAY OF JOBS WITH THIS NAME WHICH YOU OWN (IF ANY) 
FOLLOWS : 


A CANCEL by job name is refused if duplicate names 
exist in the job log file. Re-enter the CANCEL 
command, specifying "job#" rather than "Jjobname". 


* “EBCDIC" OR "EBCDIK" REQUIRED. 


EBCDIC and EBCDIK are the only valid translation 
types. Re-enter. 


* EMBEDDED BLANKS NOT ALLOWED IN QUALIFIED NAME. 


* END OF 
ERROR! 


A qualified actual file designator may not contain 
embedded blanks. Re-enter. 


FILE ON S$STDINX. FURTHER INPUT IMPOSSIBLE. FATAL 


End-of-file on standard input device (for example, a 
user enters ":EOD" while submitting from SSTDINX) 
makes further input impossible. MRJE terminates. Run 
the job again and do not use ":EOD" or ":EOF" in 
SUBMIT. Use "MRJEOD". 


NOTE 


An asterisk (*) preceding a message indicates the error 


causes 


program termination if DSN/MRJE is being run non- 


interactively. 
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DSN/MRJE User Messages (continued) 


ENTER INPUT ENDING WITH “MRJEOD". 
This message followed by a prompt (>) requests input 


from SSTDIN/SSTDINX during SUBMIT. If SSTDIN or 
SSTDINX are FD files, any comment on the ##FD card 
will appear ahead of this message. For example, 


assume infile DATA] contains the record 
##FD SSTDIN This input is for file DATAI. 


When this ##FD card is read by DSN/MRJE, the following 
appears on the terminal: 


This input is for file DATAI. 
ENTER INPUT ENDING WITH "MRJEOD" 
> 


* EXTRANEOUS INFORMATION AFTER VALID ITEM. 
Some extra information has been included that 
DSN/MRJE does not recognize. Re-enter with only the 
required information. 


* ##FD CARDS NOT PERMITTED IN LEVEL 2 FILE. 
File Definition cards may be contained only in an 
Infile (level 0) or a first-level FD file. Remove the 
#4#PD card from the named level 2 file, reconstruct 
input files as required, and re-submit job(s). 


FILE ERROR #n, filename CAN'T BE CLOSED. 
Named SUBMIT file (input or output) cannot be closed. 
SUBMIT processing continues. Determine the reason for 
the failure from MPE file system error number (#n). 


* FILE ERROR #n, filename CAN'T BE CLOSED. FATAL ERROR! 
Named file (configuration, directory, job log, or host 
console device) cannot be closed. DSN/MRJE termin- 
ated. Determine the reason for the failure from MPE 
file system error number (#n). 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages 


DSN/MRJE User Messages (continued) 


ERROR #n, filename CAN'T BE OPENED. 
Named file cannot be opened. Determine the reason for 
the failure from MPE file system error number (#n). 


ERROR #n, filename CAN'T BE OPENED. FATAL ERROR! 
Named list file (if other than SSTDLIST) cannot be 
opened. DSN/MRJE terminated. Determine the reason for 
the failure from MPE file system error number (#n). 


ERROR #n, MRJEJOBh RECORD m CAN'T BE POSTED. 
Record m of job log MRJEJOBh cannot be _ physically 
transferred from the 1/0 buffer to the disc file. 
Determine the reason for the I/O failure from MPE file 
system error number (#n). 


filename RECORD m 
ERROR #n HOST CONSOLE OUTPUT CAN'T BE READ. 
STANDARD INPUT FILE 
Named file (record m) cannot be read. Determine the 
reason for the I/O failure from the MPE file system 
error number (#n). 


ERROR #n, filename RECORD m CAN'T BE WRITTEN. 
Record m of the named file cannot be written. 
Determine the reason for the I/O failure from the 
MPE file system error number (#n). 


* FILE ERROR #n, filename RECORD m CAN'T BE WRITTEN. FATAL 


ERROR! 
An output record cannot be written to the named list 
file. DSN/MRJE terminated. Determine the reason for 
the I/O failure from the MPE file system error 
number (#n). 

FILE ERROR #n, xxxx CAN'T BE WRITTEN TO HOST READER. 


Xxxx = "filename RECORD m" or “MONITOR CARD". Record 
"m" of the SUBMIT input file, or the monitor card can- 
not be written to the host reader. (The latter asso- 
Ciates a host job with a pseudo reader.) Determine the 
reason for the I/O failure from the MPE file system 
error number (#n). 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages 


DSN/MRJE User Messages (continued) 


* FILE ERROR #n, CAN'T CLOSE SSTDINX. HOST CONSOLE COMMANDS 
CAN'T BE SENT. 
SSTDINX (standard input device) must be closed, then 
re-opened for NOWAIT I/O, in order to send host con- 
sole commands. Determine the reason for the the 
failure from the MPE file system error number (#n). 


FILE ERROR #¢n, HOST BUSY. CONSOLE COMMAND NOT SENT. 
Host pseudo console device has received more messages 
from the host than it can handle. Determine the reason 
for the failure from the MPE file sytem error (#n). 


* FILE ERROR #n, HOST CONSOLE CAN'T BE OPENED. 
Host pseudo console device specified in the configu- 


ration file cannot be opened. Determine the reason 
for the failure from MPE file system error number 
(#n). : 


* FILE ERROR #n, HOST CONSOLE COMMAND CAN'T BE WRITTEN. 
Host console command cannot be written to the host 
pseudo console device specified in the configuration 
file. Determine the reason for the I/O failure from 
the MPE file system error number (#n). 


* FILE NAME, DEVICE CLASS, OR LOGICAL DEVICE NUMBER REQUIRED. 
File name, device class, or logical device number is 
the only valid input. Re-enter. 


hostname FILES CREATED. 
The configuration file set for the named host has been 
created as requested in the NEW command. 


FOLLOWING MUST BE INITIALIZED IN CONFIGURATION FILE: 
When creating a new configuration file, certain items 
that do not have default values must be initialized. 


* FORMS SPECIFIED TWICE. 


"PORMS" file specified twice in SUBMIT command. Re- 
enter SUBMIT command, specifying FORMS only once. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages (continued) 


* GET PRIVILEGED MODE FAILURE. FATAL ERROR! 
An error occurred in the GETPRIVMODE intrinsic. This 
is an internal software failure. Contact Hewlett- 
Packard. 


* GET USER MODE FAILURE. FATAL ERROR! 
An error occurred in the GETUSERMODE intrinsic. This 
is an internal software failure. Contact Hewlett- 
Packard. 


* HOSTNAME MUST START WITH SAME CHAR AS HOSTID 
The first character of a host name must be the same as 
the first character of the host ID given in the NEW 
command. Re-enter. 





* jobname IN DIRECTORY (ENTRY n) BUT NOT IN JOB LOG. FATAL 
ERROR! 
Named job has been found in directory entry n, but 
cannot be found in the job log. DSN/MRJE terminated. 


This is an internal software failure. Do not permit 
further ‘jobs to be submitted to this job log. When 
all jobs in it have completed, use FCOPY to list the 
directory and job log as follows: 





sFILE L;DEV=LP 

:RUN FCOPY 

>F ROM=MRJEJOBh ;TO=*L 
>F ROM=MRJEDIRh :TO=*L 
>EXIT | 





("h" is the host ID.) 


Show the listing to Hewlett-Packard. Use the PURGE ALL 
command to re~initialize the directory and job log 
files. 


* INPUT FILE NAME(S) REQUIRED. 
SUBMIT requires at least one input filename. Re-enter. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages (continued) 


* INPUT MUST BE NUMERIC 
Numeric input required. Re-enter. 


INTERACTIVE TERMINAL REQUIRED FOR HOST CONSOLE COMMANDS. 
User/Manager must run DSN/MRJE interactively in order 
to send host console commands from a terminal. 
(Console commands may also be sent as part of an IBM 
JCL deck, but they must be in batch format.) 


* INVALID ACTUAL FILE DESIGNATOR. 
A fully qualified actual file designator has the form 


filename/lockword<groupname.accountname 


where names and lockword have a maximum of eight 
alphanumeric characters each, and the first character 
is alphabetic. No embedded blanks are permitted. 
Re-enter. 


* INVALID COMMAND. 
MRJE does not recognize the input as a command. Enter 
a valid MRJE or host Job Entry Subsystem command. 


* INVALID DEVICE CLASS SPECIFICATION. 
Valid device class has the form 


"name" 


where name can have a maximum of eight alphanumeric 
characters, starting with an alphabetic. No embedded 
blanks are permitted and quotation marks are required. 
Re-enter. 


* INVALID HOST SYSTEM. 
HASP, JES2, JES3, and ASP are the only valid host Job 
Entry Subsystems. Re-enter. 


* INVALID HOSTID. MUST BE ALPHANUMERIC, <=8 CHARS. 
Valid host ID has a maximum of eight alphanumeric 
characters. Re-enter. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages 


DSN/MRJE User Messages (continued) 


INVALID JOBNAME--TOO LONG. 
Eight characters is the maximum length for host job 
name. Re-enter. 


INVALID KEYWORD. 
Valid keywords are READER, PRINT, PUNCH, FORMS. Re- 
enter SUBMIT command. 


INVALID OCTAL NUMBER. 
Octal number cannot contain blanks or the digits 8 and 
9. Re-enter. 


INVALID PARAMETER FOR DISPLAY COMMAND. 
Valid DISPLAY parameters are CONFIGURATION, 


DIRECTORY, HOST, JOBLOG, OLDJOBS, STATUS. Re-enter 
DISPLAY command with correct parameter. 


INVALID SPECIAL CHARACTER. 
Re-enter using one of the following special characters 
only: »S#@/az"()>Bzp teh lbe*+—'! 


INVALID SUBMIT PARAMETER. 
Valid SUBMIT parameters are “infile" "(N)" and _ the 
keywords "READER", "PRINT", "PUNCH", and "FORMS". Re- 
enter SUBMIT command. 


device IS AN INVALID PSEUDO LINE MONITOR DEVICE. FATAL 

ERROR! 
DSN/MRJE, in determining whether the host is on-line 
or off-line, has found that the pseudo line monitor 
logical device number in the configuration file is 
invalid. Ensure that the logical device number in the 
configuration file correctly indicates the pseudo line 
monitor device configured on the 3000. 


jobname IS NOT YOUR JOB. 
Requested job will not be canceled or displayed 
because the user's logon ID does not match that in the 
job log file entry. Re-enter CANCEL or DISPLAY with 
correct job name or job number. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages (continued) 


hostname IS OFF-LINE. 
Named host is off-line. 


hostname IS OFF-LINE. HOST CONSOLE COMMAND CAN'T BE SENT. 
Host console command cannot be sent because named host 
is off-line. Re-enter command when host is on-line. 


* hostname IS OFF-LINE. JOB CAN'T BE CANCELED AT HOST. 
Job to be canceled has been transmitted to host, but 
the host is now off-line, so a CANCEL command cannot 
be sent to host. However, the cancel flag in the job 
log entry is set so that any output from the job will 
be flushed. on 


hostname IS ON-LINE. 
Named host is on-line. 


hostname IS THE CURRENT HOST MACHINE 
Named host is the host to which all succeeding com- 
mands will be directed. 


* n IS THE MAX LEVEL OF NAMES IN THIS ACTUAL FILE DESIGNATOR. ~ 
Lockword, groupname, and accountname are the only 
permissible file name qualifications. 


* n IS THE MAXIMUM NUMBER OF CHARACTERS FOR THIS PARAMETER. 
Certain inputs, such as phone number in the configur- 
ation file, cannot exceed a specified length. Reenter. 


* command IS THE ONLY VALID CONSOLE COMMAND. 
The User is permitted to use only the host’ console , 
command(s) designated by the Manager in the configu- 7 
ration file in Item 6. Re-enter. 


* m TO n IS THE VALID RANGE FOR THIS PARAMETER. 
The number specified is not within valid range. Re=- 
enter. 


ITEM 4 ONLY DISPLAYED FOR MANAGER. 
Item 4 in the configuration file (host SIGNON image) 
is displayed only for the MRJE Manager. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages (continued) 


ITEM NOT USED WITH THIS HOST SYSTEM. 


Items 11 and 17 in a configuration file are not used 
with a JES3 or ASP host. 


* ITEM NUMBER REQUIRED. 


When altering a configuration file, item number is 
required. Re-enter with an item number. 


JOB ALREADY CANCELED. 





A CANCEL request has been entered for a job which has 
already been canceled. The job log entry is dis- 
played. 


JOB #n CAN'T BE CANCELED DUE TO A PREVIOUS SYSTEM FAILURE. 





Message occurs if the system is restarted between the 
time a job is submitted and the time a CANCEL request 
is issued. System restart invalidates the spool file 
numbers that would normally be used in a cancelation 
procedure. Thus the CANCEL request fails. After 
receiving all output for all jobs, purge all old jobs. 


* JOB CAN'T BE CANCELED AT HOST FOR NON-INTERACTIVE USER. 


Job to be canceled has been transmitted to the host, 
but since the User/Manager is not running DSN/MRJE 
interactively the CANCEL command cannot be sent to 
the host. However, the cancel flag in the job log 
entry is set so that any output from the job will be 
discarded. 


JOB NOT CANCELED. 





When User/Manager requests that a job be canceled, 
the job log entry is displayed. [In an interactive 
session DSN/MRJE then asks for verification of the 
CANCEL. If the response is anything other’ than 
"YES", the job is not canceled. 


NOTE 


An asterisk (*) preceding a message indicates the error 
Causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages (continued) 


n JOBS ARE IN THE JOBLOG. VERIFY PURGE WITH “YES". 
When the Manager enters the PURGE ALL command 
DSN/MRJE checks to see whether there are any jobs in 
the job log. (These may or may not have completed. ) 
If there are remaining jobs and if the Manager is run- 
ning interactively he or she is asked to verify the 
PURGE request by typing YES. 


JOB#n NO JOBLOG ENTRY. 
No job log entry exists for the job specified in a 
CANCEL or DISPLAY command. Display by job name to 
determine the correct job number. 





* LOGICAL DEVICE NUMBER OR DEVICE CLASS REQUIRED. 
A logical device number or device class is the only e 
valid input. Back-references not permitted. 
Re-enter. 


MANAGER CAPABILITY IN EFFECT. 
This user has "OP" capability. 


* MANAGER CAPABILITY REQUIRED FOR THIS COMMAND . 
This command is not available to a user without "op" | 
capability. 


* MAXIMUM OF 5 INPUT FILES ALLOWED. 
SUBMIT will accept a maximum of five explicit input 
files. Re-enter the SUBMIT command. 


* MISSING RIGHT PARENTHESIS. ae 
Closing right parenthesis has been omitted from the : 
“(NOTRANSLATE)" parameter. Re-enter the SUBMIT com- 
mand. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages (continued) 


MRJECONh FILE ALREADY EXISTS. REPLY "YES" TO RECREATE. 
The host named in NEW command already has ae set of 
configuration files. In an interactive session the 
Manager is asked to verify that the existing files are 
to be deleted and new ones’ created. Reply YES to 
delete the existing set of configuration files. Any 
other response will retain the existing files. 


MRJECONh NOT ALTERED. 
No change has been made to the named configuration 
file because of an I/O error, invalid input, or no new 
value being entered when requested. If a change is 
required, re-enter the ALTER command. 


MRJECONh SUCCESSFULLY ALTERED. 
The named configuration file has been successfully 
altered as requested. 


MRJEJOBh COMPLETELY PURGED OF ALL JOB ENTRIES. 
Named job log has been completely purged as requested. 


MRJEJOBh DIRECTORY FULL. NO FURTHER JOBS CAN BE 

SUBMITTED. 
Directory of the named job log indicates that the job 
log is full. PURGE the named job log of old, inactive 
jobs. 


MRJEJOBh DIRECTORY/JOBLOG UPDATE CAN'T BE COMPLETED. 

FATAL ERROR! 
Some or all entries have been deleted from the job log 
during PURGE, but the job log or directory cannot be 
updated because of an I/O error. DSN/MRJE terminated. 
Rebuild the set of configuration files for this host 
using the NEW command. 


MRJEJOBh END OF FILE. 


End-of-file has been reached in search of named job 
log. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages (continued) 


MRJEJOBh n JOBLOG ENTRIES CLEARED. m FREE ENTRIES NOW 
EXIST. 
A PURGE command cleared n entries from the named _ job 
log file by: 
e deleting canceled jobs 
@® deleting timed-out jobs 
@® clearing directory entries that were reserved for 
jobs that failed during SUBMIT. 


MRJEJOBh JOBLOG IS EMPTY. 
Named job log is empty. This response may be given to 
a DISPLAY DIRECTORY, DISPLAY JOBLOG, or PURGE command. 





MRJEJOBh NOT PURGED. 
The named job log has not been purged because the Man- 
ager negated his or her request, or an I/O error 
occurred. If PURGE is required, determine the reason 
for failure from the MPE file error number given in 
the I/O error message and re-enter the PURGE command. 


MRJEJOBh n OLD JOBS IN THIS FILE. 
The named job log contains n "old jobs" -- jobs which 
have timed-out or been canceled and are therefore sub- 
ject to purging. 





MRJEJOBh n OLD JOBS PURGED THUS FAR. 
An error has occurred during PURGE processing which 
makes directory/job log update impossible. However, n 
old jobs have already been deleted from the job log. 
Rebuild the configuration files for this host using 
the NEW command. 





* (current command char) MUST BE FIRST CHAR IN USER HOST CMD. 
The specified command character must be the first 
character entered in the user host command. For 
example, if the host system command character is a 
dollar sign ($), the User host command cannot be $%DA. 


* NO BLANKS ALLOWED IN FORMAL FILE DESIGNATOR 
Embedded blanks are not permitted within a back ref- 
erenced file designator. Re-enter. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages (continued) 


CLOSING QUOTE ON DEVICE CLASS NAME. 


Valid device class must be enclosed in quotes. 
Re-enter. 


FILE DESIGNATOR ON ##FD CARD. 


JOB 


A ##FD card with no file designator has been found 
in a SUBMIT input file. Correct the ##FD card and 
re-submit. 


CARD FOUND. 

DSN/MRJE has read and spooled or transmitted all 
SUBMIT input (Infiles and FD files) without finding a 
host JOB card with the form: 


//jopname JOB optional information 
Add a valid host job card and re-SUBMIT. 


FILES CREATED. 

If an error occurs or the DSN/MRJE Manager enters 
Control-Y during NEW command processing, no new set of 
configuration files is created. If new files are 
required, determine the reason for failure from the 
MPE file error number given in the I/O error message 
and re-enter the NEW command. 


PARAMETERS ALLOWED. 


No parameters are allowed in this command. Re-enter 
the command. 


SPOOL FILE FOUND. 


Message occurs when a job is canceled and no_ spool 
file exists that contains information to be trans- 
mitted for the canceled job. 


jobname NOT FOUND. 


The job named in a CANCEL or DISPLAY command is not 
in the job log. Ensure that job name is correct and 
re-enter the command. The Manager may DISPLAY the 
entire job log to check job names. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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DSN/MRJE User Messages (continued) 


JOB NOT SUBMITTED. 
jobname 


The named job (or "JOB" if DSN/MRJE did not find a 
host card) was not submitted to the host. Make cer- 
tain the job has a recognizable job card. 


* NOTRANSLATE CAN'T BE SPECIFIED FOR SSTDIN/SSTDINX. 
Input from the standard input file is always trans- 
lated from ASCII to EBCDIC or EBCDIK, depending on 
translation type. Re-enter SUBMIT command, deleting 
the "(NOTRANSLATE)" parameter from S$STDIN/SSTDINX. a“ 


* "NOTRANSLATE" REQUIRED. 
"(NOTRANSLATE)" is the only parenthesized parameter 
allowed in the SUBMIT command. Re-enter command. 


* NUMERIC PARAMETER EXPECTED. 
Numeric input is expected after a comma. Re-enter. 





* ONLY 3 PARAMETERS ARE ALLOWED. 
Only three values (days, hours, minutes) can be 
given to specify maximum time a job remains in the 
job log after transmittal. Re-enter. 


* outfile : OUTPUT FILE DOES NOT EXIST. 
The named output file (PRINT, PUNCH, or FORMS file) 
has been given in a SUBMIT command, but has not yet 
been created. Build the named output file and re- — 
submit. 


* PARAMETERS REQUIRED. 
The given command requires parameters. Re-enter the 
command. 


* PRINT SPECIFIED TWICE. 


PRINT file specified twice in SUBMIT command. Re- 
enter command, specifying "PRINT" once only. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- i 
interactively. 
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DSN/MRJE User Messages (continued) 


PUNCH SPECIFIED TWICE 
PUNCH file specified twice in SUBMIT command. Re- 


enter command, specifying “PUNCH" once only. 


reader READER CANNOT BE CLOSED. 
The named host pseudo reader cannot be closed. Deter- 
mine the reason for the failure from MPE file error 
number. 


READER SPECIFIED TWICE. 
READER file specified twice in SUBMIT command. Re- 
enter command. 


SPOOL FILE DELETED. 
Message occurs when a job is canceled before it is 
transmitted to the host and the spool containing it 
is deleted. 


SPOOL FILE NOT IN READY STATE. UNABLE TO DELETE. 
Message occurs when a job is canceled while it is 
being transmitted to the host. The spool file is 
busy and cannot be deleted. 


STANDARD INPUT FILE CAN'T BE OPENED. FATAL ERROR! 
SSTDINX cannot be opened. DSN/MRJE terminates. 


STANDARD INPUT FILE CAN'T BE OPENED FOR NOWAIT 1/o. 
SSTDINX must be opened for NOWAIT I/O in order to send 
host console commands. 


SSTDIN, SSTDINX, SOLDPASS ARE ONLY SYSTEM INPUT FILES 
ALLOWED. 
Only those system files named in the message can be 
used for Input or FD files. Other system files are 
prohibited. Re-enter SUBMIT with valid input files. 


THIS ITEM NOT DYNAMICALLY CONFIGURABLE. 
Items 1, 18, 40, and 41 in the configuration file can- 
not be altered after the file has been created. In 
order to change these items, use the NEW command to 
reconstruct the configuration file. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 


Appendix G (Communications Handbook Section E)-37 


DSN/MRJE User Messages 





DSN/MRJE User Messages (continued) 


USER CAPABILITY IN EFFECT. 
This user does not have "OP" capability, and cannot 
carry out DSN/MRJE Manager functions. 


* VALID RESPONSE MUST BE GIVEN. 
When creating a new set of configuration files, items 
that do not have default values must be initialized. 
DSN/MRJE continues to ask for a valid response until 
one is given or until the Manager enters Control-y, in 
which case no new files are created. 


VERIFY CANCEL WITH "YES". 
When User/Manager requests that a job be canceled, a“ 
the job log entry is displayed. In an interactive | 
session DSN/MRJE then asks for verification of the 
CANCEL. Reply YES to verify cancellation. 


WARNING: HOST COMMAND CARD FOUND IN INPUT-NOT TRANSMITTED. 
DSN/MRJE did not transmit the record to the host. 
SUBMIT processing continues. 





WARNING: MRJEOD CARD FOUND IN INPUT-NOT TRANSMITTED. 
An MRJEOD card is only required when an input file 
(Infile or FD file) is S$STDIN or SSTDINX. If an 
MRJEOD card is found in any other input file it is 
not transmitted to the host. SUBMIT processing con- 
tinues. 


WARNING: SIGNOFF CARD FOUND IN INPUT-NOT TRANSMITTED. 
A signoff card has the form: - 


/ *SIGNOFF 


DSN/MRJE did not transmit this record to the host. 
SUBMIT processing continues. 


* "YES" OR "NO" REQUIRED. 
YES or NO is the only valid response. Re-enter. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. - 
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DSN/MRJE User Messages (continued) 


* YOU MUST LOG ON MANAGER.SYS TO CREATE/PURGE CONFIG FILES. 
The MRJE Manager must be logged on to MANAGER.SYS, PUB 
to create a set of configuration files (NEW command) 
or to purge all entries from the job log (PURGE ALL), 
since the files are in PUB.SYS. 


NOTE 


An asterisk (*) preceding a message indicates the error 
causes program termination if DSN/MRJE is being run non- 
interactively. 
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MRJECONTROL Console Messages 


The messages in this table can be received by DSN/MRJE users 
while using :MRJECONTROL commands. 


CIERR (OR) 
NUMBER 


4200 


4201 


4202 


4203 


4204 


4205 


4206 


MESSAGE, MEANING AND RECOVERY 


EXPECTED ONE OR MORE OF THE CONTROL FUNCTIONS ; 
START, TRACE, RETRIES, SIGNOFF OR KILL. 
Entering "MRJECONTROL" alone is not OK. Enter 
“"MRJECONTROL" plus one of the control commands 
listed in the message. 


EXCEEDED MAXIMUM NUMBER OF PARAMETERS. 


Look up syntax of DSN/MRJE command and =“re- 
enter using no more than the maximum number of 
paramters allowed. 


START ALREADY REQUESTED. 
The sMRJECONTROL START command has already 
been issued, but the line is not fully open. 
Before the command can again be _ successfully 
issued, the :MRJECONTROL SIGNOFF or 
sMRJECONTROL KILL command must be executed. 


EXPECTED TWO PARAMETERS, HOSTID AND RETRYNUM. 
Re-enter command using both parameters. 


UNABLE TO OPEN CONFIGURATION FILE FOR THIS HOST. 
There are several possible reasons for this 
message: 


1) The wrong host ID may have been used in 
command. 

2) Someone may be altering or rebuilding 
the configuration file. 

3) There may be no configuration file for 
this host. 


UNABLE TO ACCESS CONFIGURATION FILE FOR THIS 
HOST. 


An FWRITE to or FREAD from the file failed. 


INSUFFICIENT CAPABLITIES FOR MRJECONTROL 

COMMANDS. 

A user must be authorized to use MRJECONTROL con- 
mands through the MPE :ALLOW command. 
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CIERR (OR) 
NUMBER 


4207 


4208 


4209 


4210 


4211 


4212 


4213 


4214 


4215 


4216 
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MRJECONTROL Console Messages (continued) 


MESSAGE, MEANING AND RECOVERY 


UNABLE TO CREATE MRJEMON. 
Do a LISTF on MRJEMON.PUB.SYS to see if 


file 


exists. If it doesn't, check MPE configuration. 


UNABLE TO ACTIVATE MRJEMON. 
Do a LISTF on MRJEMON.PUB.SYS to see if 
exists. If it does, check MPE configuration. 


MRJE ALREADY ACTIVE. 


Line already open. Command is ignored. 


NUMBER OF RETRIES MUST BE IN RANGE 1 — 255. 
Re-enter command with "RETRIES" within range. 


SIGNOFF ALREADY REQUESTED. 


file 


Command in process. If line won't close, it may be 


necessary to issue :MRJECONTROL KILL. 


KILL ALREADY REQUESTED. 


:MRJECONTROL KILL command already has been 


quested. 
to physically disconnect it. 


INVALID DEVICE FOR MRJEO. 

The logical device numbers entered for items 
and three of configuration file are different 
logical device numbers used in MPE I/O system 
figuration. Alter configuration file entries. 


EXPECTED AT LEAST ONE PARAMETER, “ON" OR "OFF". 


The TRACE command must be issued with either 
or "OFF" specified. 


MRJE NOT ACTIVE. 
Start DSN/MRJE (:MRJECONTROL START) and _ then 
issue command. 


NO SYSTEM BUFFER AVAILABLE. COMMAND FAILED. 
Re-issue command until it succeeds. 
persists, contact Hewlett-Packard. 
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MRJECONTROL Console Messages (continued) 


CIERR(OR) MESSAGE, MEANING AND RECOVERY 
NUMBER 
4217 "TRACE" ONLY VALID COMMAND HERE. 
4218 MRJEMON ADOPT FAILURE. 


Contact Hewlett-Packard. 


4219 HOST ID MUST BE ALPHANUMERIC. 
Host ID may not contain a special character. 


4220 SIGNOFF INVALID UNTIL HOST CONNECTION COMPLETED. 


:MRJECONTROL SIGNOFF cannot be executed until the 
communications line is open. 
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DSN/MRJE Messages Sent to System Console 


NOTE 


A number of DSN/MRJE messages are sent to the system console 
only. The messages have the following format: 


MRJE message 
time/pin/ MRJEh WARNING: message 
ERROR: message 


Message items are: 


time The time of day the message was sent. 
pin The MPE process identification number. 
MRJE Indicates DSN/MRJE generated the message and that 


the message concerns the default host system. 


MRJEh Indicates DSN/MRJE generated the message and 
that the message concerns the host system whose 
ID begins with "h". 


message The message itself. 
WARNING: This message reports a potential problem. 
ERROR: This message reports a failure. 


ACTIVATE FAILURE ON MRJEMON. 
Internal software error. Contact Hewlett-Packard. 


CONFIGURED BUFFER SIZE INVALID. 
Buffer size in the MRJE configuration file (Item 43) 
is invalid. The MRJE Manager must alter the item in 
the configuration file to agree with the host system's 
buffer size. 


CONSMRJE, OPEN FAILURE (nn) ON SNULL. 
File system error nn. Contact Hewlett-Packard. 


CONSMRJE, OPEN FAILURE (nn) ON MRJECONh. 
The specified MRJE configuration file could not be 
opened; see if it exists. If it does, determine the 
cause of the the failure from the file system error 
number (nn) and take corrective action. 
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DSN/MRJE Messages Sent to System Console (continued) 


CONSMRJE, READ FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


CONSMRJE, WRITE FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


CREATE FAILURE ON MJOBLOGR. 
A job-logging process could not be created. Ensure 
that MRJELOGR is present in PUB.SYS. 


CREATE FAILURE ON MRJEMON. 
An DSN/MRJE monitor process could not be created. 
Ensure that MRJEMON is present in PUB.SYS. 


CREATE FAILURE ON MRJEOUT. 
An DSN/MRJE output process could not be created. 
Ensure that MRJEOUT is present in PUB.SYS. 


DATA RECEIVED FOR INVALID UNIT #nn. 

The host system has sent data to an unconfigured 

pseudo device. | 

1. Backspace the host unit (nn). 

2. Drain host unit (nn), 

3. As soon as convenient, reconfigure the DSN /MRJE 
pseudo I/0 devices so that the host and the HP 
3000 system have the same configuration. 


DSN/MRJE pseudo devices should be configured with the 
following unit numbers: | 


2 pseudo console 
3 thru 9 pseudo line printers 1 thru 7 
10 thru 16 pseudo punches 1 thru 7 


DIAL REMOTE number. 
The communications link has. been initially estab- 
lished. Dial the number’ shown in the message and 
complete the connection. This message is printed 
only if the SSLC or INP is configured for a switched 
(not a leased) line. 
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DSN/MRJE System Console Messages (continued) 


HOST BLOCK SEQUENCE (nl,n2). 
A block sequence error occurred on the CS device. 
Block n2 was received when block nl was expected. 
Normally, MRJE will recover from this condition. If 
the problem recurs, contact Hewlett-Packard. 


HOST BUFFER SIZE (nnnn) EXCEEDS MAXIMUM. 
The value specified in the MRJE configuration file for 
the host buffer size exceeds 2048. The MRJE Manager 
should alter Item 43 in the configuration file. 


HOST # NOT ENTERED FOR 3000 JOB #nnn. 
All. output received from job nnn was sent to one of 
the unsolicited output device specified in MRJE con- 
figuration file. 


INVALID BUFFER RECEIVED FROM HOST. 
The last buffer of data received from the host had 
contradictory or invalid control information. Contact 
Hewlett-Packard. 


INVALID DEVICE FOR MRJEO. 
The logical device number configured in the MRJE con- 
figuration file for the pseudo line (Item 3) is not 
the same as the number configured into MPE for 
IOMRJEO. The MRJE Manager must alter the logical 
device number in the configuration file (#ALTER 
command). 


KILL ALREADY REQUESTED. 
The :MRJECONTROL KILL message has already been issued, 
but unsuccessfully. Subsequent KILL commands for’ the 
same host cause this message. If MRJE does not dis- 
connect the line, you may need to physically dis- 
connect it. If MRJE repeatedly fails to close the 
line after a KILL is issued, contact Hewlett-Packard. 


LOCKSEG FAILURE. 
LOCKSEG Intrinsic failure. Internal software problem. 
Contact Hewlett-Packard. 


nl BLOCK SEQUENCE RECOVERY. EXPECTED BLOCK n2. 

RECEIVED BLOCK n3. 
While data was being transmitted to the host system, 
block n3 was received when block n2 was to have been 
sent. There were nl blocks recovered. MRJE will nor- 
mally recover from this condition. If the problem 
persists, contact Hewlett-Packard. 
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DSN/MRJE System Console Messages (continued) 


MRJELOGR, FINFO FAILURE (nn) ON MRJEDIRh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


MRJELOGR, JOB TRANSMITTED TO WRONG HOST. — 
In HP 3000 systems configured with two or more MRJE 
subsystems, jobs can be transmitted to the wrong host 
if the same pseudo card reader is configured in more 
than one MRJE configuration file. 


MRJELOGR, OPEN FAILURE (nn) ON SNULL. 
File system error nn. If severe, contact Hewlett- 


Packard. o— 


MRJELOGR, OPEN FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, contact HP. 
DSN/MRJE System Console Messages (continued) 


MRJELOGR, OPEN FAILURE (nn) ON MRJEDIRh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


MRJELOGR, OPEN FAILURE (nn) ON MRJEJOBh. 
File system error nn. If severe, contact Hewlett-— 
Packard. 


MRJELOGR, READ FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, contact Hewlett- 


Packard. 

MRJELOGR, READ FAILURE (nn) ON MRJEDIRh. ) 
File system error nn. If severe, contact Hewlett-— | 
Packard. 


MRJELOGR, READ FAILURE (nn) ON MRJEJOBh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


MRJELOGR, WRITE FAILURE (nn) ON MRJEDIRh. 
File system error nn. If severe, contact Hewlett-— 
Packard. 


MRJELOGR, WRITE FAILURE (nn) ON MRJEJOBh. 


File system error nn. If severe, contact Hewlett- 
Packard. 
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DSN/MRJE System Console Messages (continued) 


MRJEMON, OPEN FAILURE (nn) ON CS DEVICE. 
The MRJE monitor could not open the line. The CS 
error number (nn) references the reason for the 
failure. CS error codes are listed in the Data 
Communications Handbook Section I. 


MRJEMON, OPEN FAILURE (nn) ON SNULL. 
File system error nn. If severe, contact Hewlett- 
Packard. 


MRJEMON, OPEN FAILURE (nn) ON MRJEO. | 
The DSN/MRJE pseudo line monitor file could not be 
opened. (nn) specifies the MPE file system error 
number which identifies a reason for the failure. If 
the problem is severe, contact Hewlett-Packard. 


MRJEMON, OPEN FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


MRJEMON, READ FAILURE (nn) ON CS DEVICE. 
The communication link to the host failed. The CS 
error number (nn) identifies the reason for the 
failure. CS errors are in Handbook Section I. 
If the problem is severe, contact Hewlett-Packard. 
DSN/MRJE System Console Messages (continued) 


MRJEMON, READ FAILURE (nn) ON MRJEO. 
File system error nn. If severe, contact Hewlett- 
Packard. 


MRJEMON, READ FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


MRJEMON, WRITE FAILURE (nn) ON CS DEVICE. 
If this message appears as a WARNING, a communica- 
tion problem developed and DSN/MRJE sent a SIGNOFF 
command prior to disconnecting the line. The host 
system probably has accepted the command and is 
closing the communications link. 


Tf this message appears as an ERROR, the communica- 
tions link failed unexpectedly. Irrecoverable com- 
munication error codes are in Handbook Section I. fMThe 
CS error number references the reason for the failure. 
Contact Hewlett-Packard, if such errors persist. 
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DSN/MRJE System Console Messages (continued) 


WRITE FAILURE (nn) ON MRJEO. 


File system error nn. If severe, contact 

Packard. 

WRITE FAILURE (nn) ON MRJECONh. 

File system error nn. If severe, contact 
Packard. 

CLOSE FAILURE (nn) ON MRJECONh. 

File system error nn. If severe, contact 
Packard. 

FINFO FAILURE (nn) ON MRJE'PNLP. 

File system error nn. If severe, contact 
Packard. 

FINFO FAILURE (nn) ON MRJEOUT. 

File system error nn. If severe, contact 
Packard. 

OPEN FAILURE (nn) ON SNULL. 

File system error nn. If severe, contact 
Packard. 

OPEN FAILURE (nn) ON MRJE'PNLP. 

File system error nn. If severe, contact 
Packard. 

OPEN FAILURE (nn) ON MRJECONh. 

File system error nn. If severe, contact 
Packard. 

OPEN FAILURE (nn) ON MRJEDIRh. 

File system error nn. If severe, contact 

Packard. 

OPEN FAILURE (nn) ON MRJEJOBh. 

File system error nn. If severe, contact 
Packard. 


OPEN FAILURE (nn) ON MRJEOUT. 
DSN/MRJE couldn't open a User's output file. 
destined for the file is irrecoverable. 
DSN/MRJE Users that output was lost. This 
system error nn. If severe, 


Hewlett— 


Hewlett- 


Hewlett- 


Hewlett=- 


Hewlett-= 


Hewlett- 


Hewlett- 


Hewlett-— 


Hewlett- 


Hewlett- 


Output 
Notify 


is file 


contact Hewlett-Packard. 











MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


MRJEOUT, 


NO 3000# 
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READ FAILURE (nn) ON MRJE'PNLP. 
File system error nn. If severe, contact Hewlett- 
Packard. 


READ FAILURE (nn) ON MRJECONh. 
File system error nn. If severe, contact Hewlett- 
Packard. 


READ FAILURE (nn) ON MRJEDIRh. 
File system error nn. Contact Hewlett-Packard. 


READ FAILURE (nn) ON MRJEJOBh. 

When nn=0, it indicates that unsolicited output that 
doesn't belong to any entry in the job log file was 
received. When nn does not equal zero, an internal 
software error has occurred. In the latter case, 
contact Hewlett-Packard. 


WRITE FAILURE (nn) ON MRJE'PNLP. 
This message should be ignored. 


WRITE FAILURE (nn) ON MRJEOUT. 

DSN/MRJE couldn't write to a user's file. Output des- 
tined for the file is irrecoverable. Notify DSN/MRJE 
users that output was lost. Contact Hewlett-Packard. 


FOR HOST JOB# nnnn, jobname. 

Internal software problem. All output received for 
JOB# mnnn was sent to the unsolicited output devices 
specified in the DSN/MRJE configuration file. If the 
problem is severe, contact Hewlett-Packard. 


NO SYSTEM BUFFER FOR SIGNOFF. 


An :MRJECONTROL SIGNOFF command failed because no HP 
3000 system buffers were available. Wait and try 
again. If this problem occurs’ frequently, contact 
Hewlett-Packard. 
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DSN/MRJE System Console Messages (continued) 


PHYSICAL BOUNDS OF OUTFILE EXCEEDED FOR IBM JOB nnnn PLEASE 

RESPOND "RETRY" OR "FLUSH". 
The file specified to receive output for host job nnnn 
appears to be full. Writing to the file is suspended 
until the console operator responds to the message. A 
FLUSH response causes the remaining job output to be 
sent from the host, but the data is lost. Notify the 
owner of job nnnn that output was lost. A RETRY re- 
sponse causes the system to attempt to rewrite the 
lost record. Use RETRY only after attempting to 
identify and rectify the cause of the message. If the 
rewrite fails, this message is repeated until a_ retry 
is successful or until a FLUSH response is given. 





PRINTER O TERMINATING. 
Internal software error. A printer or punch output 
process terminated, but DSN/MRJE cannot determine 
which one. Contact Hewlett-Packard. 


PRINTER n TERMINATING. 

Internal software error. The DSN/MRJE output process 

corresponding to printer n terminated. 

1. If no SIGNON COMPLETED message has been received, 
enter the :MRJECONTROL KILL [,hostid] command. 

2. If a SIGNON COMPLETED message was received, back- 
space host printer n to the start of the data set. 

3. Drain all host printers and punches. 

4. Enter the :MRJECONTROL SIGNOFF [,hostid] command. 

5. In either case, contact Hewlett-Packard. 








PUNCH n TERMINATING. 

Internal software error. The DSN/MRJE output process 

corresponding to punch n terminated. 

1. If no SIGNON COMPLETED message has been received, 
enter the :MRJECONTROL KILL [,hostid] command. 

2. If a SIGNON COMPLETED message was received, back- 
space host punch n to the start of the data set. 

3. Drain all host printers and punches. 

4. Enter the :MRJECONTROL SIGNOFF [,hostid] command. 

5. In either case, contact Hewlett-Packard. 


SIGNOFF ALREADY REQUESTED. 
The :MRJECONTROL SIGNOFF command has already been 
entered. (If the SIGNOFF command is issued while the 
host is transmitting, transmission continues until the 
current data set has been received; then the line is 
disconnected.) 
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DSN/MRJE System Console Messages (continued) 


SIGNON COMPLETED. 
The :MRJECONTROL START command has’ successfully exe- 
cuted and the communication link is now open. If jobs 
have been submitted, DSN/MRJE will automatically begin 
transmitting data and accepting output. 


SYSTEM ALREADY ACTIVE. 
The :MRJECONTROL START command was issued for a host 
that is already connected. 


SYSTEM NOT ACTIVE. 
The :MRJECONTROL SIGNOFF (or KILL) command was’ issued 
for a host that is not connected. 


TERMINATING. 
The DSN/MRJE monitor process terminated. When printed 
alone (that is, without an accompanying ERROR or 
WARNING message), the termination was normal. 


UNABLE TO OPEN UNSOLICITED OUTPUT FILE FOR IBM JOB nnnn 

PLEASE RESPOND “RETRY" OR "FLUSH". 
The device or file specified to receive unsolicited 
output cannot be opened. The output procedure is sus- 
pended until the Console Operator responds to the 
message. A FLUSH response restarts output from the 
host, but all data is lost. Notify the owner of job 
nmnnn that output was lost. A RETRY response causes 
the system to try again to open the device or file. 
Use RETRY only after attempting to identify and 
rectify the cause of the message. If the specified 
device file still cannot be opened, this message is 
repeated until RETRY is successful or until a FLUSH 
response is given. 


UNLOCKSEG FAILURE. 
The UNLOCKSEG intrinsic failed. Internal software 
error. 
1. COOLSTART the system (to reclaim the line moni- 
tor's stack). 
2. Contact Hewlett-Packard. 


ZSIZE ERROR. 


The ZSIZE intrinsic failed. Internal software error. 
Contact Hewlett-Packard. 
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BINARY SYNCHRONOUS COMMUNICATIONS (BSC) MULTILEAVING BLOCK 
STRUCTURE IN BYTES: 


Character: 


DLE 
STX 
BCB 


FCS1 
FCS2 


RCB 


SRCB 


SCB 


+e + e & 


+ 


text 


RCB 


DLE 
ETB 


BCC] 
BCC2 


* 


Description: 


BSC leader (%020, !10) 

BSC start of text (%002, !02) 

Block Control Byte 

Function Control Sequence Byte 1 of 2 
Function Control Sequence Byte 2 of 2 
Record Control Byte, first record 
Sub-Record Control Byte, first record 


String Control Byte, first record 

character string, first record 

repeat SCB-text sequence until SCB=0 

repeat RCB-SRCB-SCB-text sequence as needed. 


Transmission block terminator is RCB=0 


BSC leader (%020, !10) 
BSC ending sequence (%046, !26) 


Block Check Character 1 of 2 
Block Check Character 2 of 2 


Description of this byte follows. 


Reference: OS/VS2 JES2 Logic Reference Manual, Appendix B, (IBM 


SY28-062 


2) 


BCB (Block Control Byte): Transmit block status and sequence 


count. 


1 

000 
001 
010 
Oll 
100 
101 
110 
111 


01234567 
ox xxcccece 


must always be on. 

normal block 

bypass sequence count validation 

reset expected block sequence to c value 
reserved, not supported 

reserved, not supported 

available for user modification, not supported 
available for user modification, not supported 
reserved for expansion, not supported 


modulo 16 block sequence count 
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FCS (Function 


Transparent Text Block Used by DSN/RJE 


Control Sequence): Controls the flow of individual 


function streams. 


Device number, 


RD or PR: 
PU: 
o= 1 
r 
s= 1] 
6) 
t = 0 
1 
a-dz= 0 
W- Z 
a-dadae= I] 
w- Z 


Ken --FCS lem--> <=---FCS 2---~> 
012345 6701234567 
os rrabe otrr Zz 
LZ eo 

7 6 


of Qs 
& Us 
W OV 
NI AKG 


1 


must always be on to be valid in both bytes 
reserved in both bytes 

normal state 

wait a bit. Receiver is to suspend all 
transmission. 

suspend remote console stream transmission. 
continue remote console stream transmission. 
suspend device transmission. 

For example, a = 0 means suspend RDI or PRI. 


continue device transmission 
For example, b = 1 means continue RD2, PR2 or PU7. 


RCB (Record Control Byte): Identifies record type. Uniquely 
identifies data streams among identical record types. 


o= 0 
1 


ct 
ll 


0000 
oool 
0010 
OOll 
0100 
0101 
0110 
O11l1 


01234567 
O11 2k ee et 


end of transmission. RCB=0. 
normal state. 


control record. See the values of i, below. 
operator message display request, host to system 
Operator command, system to host 

normal input record. See note 1, following. 
printer record. See note 1, following. 

punch record. See note 1, following. 

data set record. Unsupported. 

terminal message routing record. Unsupported. 


1000-1100 reserved for expansion. Unsupported. 
1101-1111 reserved for local modification. Unsupported. 
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Settings for control record, where t = 0000: 


i = 000 
O01 


010 
Oll 
LOO 
101 
110 


111 


reserved for future expansion 

request to initiate function transmission. See 
note 2, following. 

permission to initiate function transmission. See 
note 2, following. 

reserved. Unsupported. 

reserved. Unsupported. 

available for local modification. Unsupported. 
error in block check sequence. SRCB contains 
value. 

general control record. SRCB contains the type. 


Note 1: In this instance the value of the i field identifies the 
stream number of the data for a reader, a printer, or a 
punch. 

Note 2: In this instance the SRCB must contain the prototype 


RCB. 


This identifies the device which is the object of 


the request to intiate function transmission, and the 
permission to initiate function transmission. 


SRCB (Sub-Record Control Byte): Provides supplementary 
information about a record. 


01234567 
Osssssss 
must always be on 


additional information according to the record 
type. 


SRCB (Sub-Record Control Byte) for a general control record, 
where the i field of an RCB=7. Identifies type. 


Ss = 


HHmAAHON Wy 


t 
NA 


initial terminal signon 

final terminal signoff 

print initialization record. Not supported. 
punch intiialization record. Not supported. 
input initialization record. Not supported. 

data set transmission record. Not supported. 
system configuration status. Not supported. 
diagnostic control record. Not supported. 
reserved. Not supported. 

available for local modification. Not supported. 
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Transparent Text Block Used by DSN/RJE 


SRCB (Sub-Record Control Byte) for print records. Provides 
carriage control information. 


0-1. 2 <3 Ay 'S. “6-7 
omccccce 
o= 1 must always be on 
m= 0 normal carriage control 
1 reserved for future user. Unsupported. 
c = 000000 Suppress space 
OO00Oxx Space xx lines after print 
Olxxxx skip to channel xxxx after print 
1000xx space immediately xx lines 
11xxxx skip immediately to channel xxxx 





SRCB (Sub-—Record Control Byte) for punch records. Provides 
additional information. 


01234567 
ommbrrses 
eo o= ] must always be on 
m = OO SCB character count unit = 1] 
O1 SCB character count unit = 2. Unsupported. 
10 SCB character count unit = 4. Unsupported. 
1l reserved. Unsupported. 
b= 0 normal EBCDIC card image 
1 column binary card image. Unsupported. 
r reserved. Unsupported. 
Ss punch stacker selection number. 





SRCB (Sub-record Control Byte) for input records. Provides 
additional information. 


01234567 
ommbrrrrer 
o= 1 must always be on 
m = OO SCB character count units = 1 
O1 SCB character count units = 2. Unsupported. 
10 SCB character count units = 4. Unsupported. 
1l reserved. Unsupported. 
b= 0 normal EBCDIC card image. 
1 column binary card image. Unsupported. 
r reserved. Unsupported. 
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SRCB (Sub-Record Control Byte) for terminal message routing 
records. Indicates destination. Not supported at all. 


01234567 
OES ee. S Eoe 


o= 1 must always be on 
t = 0 broadcast to all systems. Unsupported. 
1-99 remote system number. Unsupported. 


100-127 remote system group. Unsupported. 


SCB (String Control Byte) identifies type and length of a 
character string. 
01234567 
okijjji3 
o = 0 end of a record. SCB = 0 
1 all other SCB values. 


k = QO duplicate character string: 
i=0 duplicate character is a blank. The next 
character is another SCB. 
i=] duplicate character is not a blank. The next 
character is duplicated. 
5 This is the duplication count. The maximum 
value is 3l. 


k = ] non-duplicate character string. Text characters 
follow this SCB. 
ij This is the text string length. The maximum 


value is 63. 
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DSN/MRJE Communication Line Specifications 


DSN/MRJE Communication Line Specifications 


Parameter Setting Comment 
formaldesig empty prevents use of CLINE 
device SSLC configured value 
coptions reference communications options. See coptions 
parameter below, and Section I of the Data 
Communications 
Handbook. 
aoptions value access options. See aoptions, below, and 
parameter Section I of the Data Communications 
Handbook. 
doptions value driver options. See doptions, below and 
parameter Section I of the Data Communications 
Handbook. 
numbuffers 0 no buffering to be done 
buffsize empty not applicable. See numbuffers. 
iolist empty received id sequences ignored 
suplist empty multipoint use only 
pollist empty multipoint use only 
awnldfile empty for INP 
YYY empty reserved for future use 
phonelist empty not used 
inspeed empty not used 
outspeed empty not used 
miscarray specified 8,0, 20,1, 60,2,0,5,255 See Section I of 
the Data Communications Handbook. 
drivername CSSMRJEO string value set 
ctraceinfo empty not used 
0123456789012345 coptions = %050203 
O:1 01:0 0 0:0 10:0 00:0121 
| | | | transmission code is EBCDIC 
! | | local is secondary contention station 


use configured default speed setting 
| prohibit use of :CLINE command. 


| do not invoke CS trace facility 
inhibit use of ID sequences 


allow timeouts 
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0123456789012345 aoptions 
0:0 0 0:0 01:0 0 O:111:0 Ol 001071 (with autodialing) 
0:0 0 0:0 01:0 0 O:11i21:1 Ol 001075 (without). 


| | | perform all I/O using CIO 

| | | allow CLINE buffer override. 

| | 10 = dial on write and read connect 
| [| 11 = answer on write connect; answer 
| | on read connect. 

| inhibit CS hardware error messages at 
| | console 

| reserved: 1 


use conversation BSC protocol 
45 doptions = %000020 


Of 
un 
OV 
~] 
© 
\O 
O 


1 0 
| send four leading SYN characters 


| | reserved for future use 
| |_MFW placed into and expected in text 
|_ no ITB expected from remote 
| | automatic generation of TTD 
| automatic generation of WACK 
BCC is VRC/LRC for non-transparent or transparent 


with heading and CRC16 for transparent without 
| headin 
| ending sequence is BSC default: EOT for non-switched, 


| DLE EOT for switched lines 
control state listen mode between user requests ignores 
| control sequences 
| poll termination: transmit RVI to return line to control 
mode 
delay sequence: wait on received WACK/TTD sequences 


reserved for future use -— 
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DSN/MRJE Pseudo Device Configuration 








TERM REC DRIVER Pseudo 
LDEV DRT UNIT CH TYPE S T WIDTH DEV M_ NAME CLASS Device 

++ 0 0 22 O 40 0 IOMRJEO Monitor 1* 
— # 12 Oo 22 0 40 O IOMRJE1 Monitor 2* 
— £€¢ 2 O 22 O 67 O IOMCONSO CON * 
— # 3 O 22 0 67 0 IOMPNLPO PR1 * 
— #€ 4 +O 22 0 67 ©) IOMPNLPO PR2 
— #€ 5 O 22 0 67 0 IOMPNLPO PR3 
— #€ 6 O 22 O 67 0 IOMPNLPO PR4 
— # 7 O 22 O 67 e) IOMPNLPO PR5 
~~ #€ 8 O 22 O 67 ©) IOMPNLPO PR6 
— #€ 98 O 22 O 67 0 IOMPNLPO PR7 
_. #. 10 #O 22 O 40 0 IOMPNLPO PU1 

# 11 O 22 O 40 0 IOMPNLPO PU2 
— #€ 12 #O 22 0 40 0 IOMPNLPO PU3 
— # #4213 #O 22 O 40 0 IOMPNLPO Pu4 
— # 14 0 22 0O 40 ©) IOMPNLPO PU5 
—_ #. 15 0 22 0 40 0 IOMPNLPO PU6 

# 16 #O 22 O 40 O ITOMPNLPO PU7 
—_ # #417 + +O 22 O 40 O S IOMRDRO MRDR1 RD1 * 

# 18 O 22 O 40 0 IOMRDRO RD2 
— #. #219 +O 22 O 40 0 IOMRDRO RD3 

# 20 O 22 O 40 0 IOMRDRO RD4 
— # £421 #0 22 O 40 0 IOMRDRO RD5 

# 22 OO 22 0O 40 0 IOMRDRO RD6 
_ # £423 #O 22 0 40 0 IOMRDRO RD7 

S = spooled Required = * 

An SSLC, device type 18, must be configured with the driver, 
CSSMRJEO, as changeable. An INP, device type 17 is not to be 
configured with a changeable driver. The download files for an 
INP ares 


CSDMRJEO for an HP 30010A; 
CSDMRJE1 for an HP 30020A; 
CSDMRJE2 for an HP 30020B. 
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INDEX 


# (pound sign), defined, xv 

& (ampersand), line continuation character, 3-16 
x... (ellipsis), defined, xii 

[] (brackets), defined, xii 

{} (braces), defined, xiii 


A 


Actual file, defined, xiv 
Actual file designator, 
use in directing job output, 3-14 
use in specifying Infiles, 3-12 
ALLOW command, MPE, 5-1 
ALTER Manager command, 
altering configuration files with, 4-7, 4-8, A-l 
summary of syntax and functions, 4-9 
using the command, 4-10 
ALTSEC command, MPE, 5-5 
Alternate character sets for output, 4-10, A-5 
Ampersand (&), line continuation character, 3-16 
ASCII character set, F-l 
ASCII-EBCDIC-Hollerith character conversions, F-2 
ASP Job Entry Subsystem, 2-1 
configuring for DSN/MRJE, E-3 
Auto dialing, 4-5, 5-5, D-9, D-19, D-20 


Banners, printer and punch, 4-6, A-2, A-3, A-7, A-8 
Batch jobs, 1-1 
Bell modems, 

201C modem options, C-4 

201C-L1D modem options, C=-2 

208A modem options, C=-5 

208B modem options, C-6 

209A modem options, C-7 


Index—-] 


Blanks, using in commands, xiii 
Braces "{}", meaning of, xiii 
Brackets "[{]", meaning of, xii 


CANCEL Manager command, 
summary of syntax and function, 4-9 
using the command, 4-12 
CANCEL User command, 
summary of syntax and function, 3-1 
using the command, 3-3 
Card (image), 1-4, 2-1, 2-2 
Card reader, physical, 2-1 
Carriage control in output files, 2-7 
Character sets, ASCII and EBCDIC, F-l, F-3 
Commands, | 
DSN/MRJE Manager, Section IV 
DSN/MRJE User, Section III 
errors, 6-1 
:MRJECONTROL Console Operator, Section V 
spelling conventions, xii 
Communications controller, 
configuration, 4-2, Appendix D 
DSN/MRJE hardware element, 4-1 
MPE configuration specifications, D-1 
use by multiple subsystems, D-5, D-18 
Communications Handbook, Appendix G 
Communications line, 1-1, 
closing via :MRJECONTROL SIGNOFF command, 5-6 
closing after host failure, 6-2 
Closing after HP 3000 failure, 6-2 
closing after line failure, 6-2 
configuration into MPE, D-1,ff 
configuring on host system, Appendix E 
control of, Section 5 
creating management files for, 4-19 
emergency close, via MRJECONTROL KILL, 5-7 
finding status of, 3-6 
leased, 1-1, C-1 
open for unspooled ("hot") input, 3-l2ff 
open for interactive use of host commands, 4-28 
opening via :MRJECONTROL START command, 5-3 
switched, C-1l 
tracing errors on, 5-3, 5-9 
transmission retries after errors on, 5-8 
viewing status of via DISPLAY command, 4-15 
CONFIG, parameter in User DISPLAY command, 3-6 
Configuration, 


Index-2 











o, 


“a ASP system for DSN/MRJE, E-3 
| HASP system for DSN/MRJE, E-1 
JES2 system for DSN/MRJE, E-2 
JES3 system for DSN/MRJE, E-3 
MPE to include DSN/MRJE, Appendix D, 
figure, D-4 
specifications, D-1, D=-2 
SSLC and INP, summary of, D-18ff 
host system for DSN/MRJE, Appendix E 
Configuration dialog, MPE, D-5ff, 
common to all devices, D-6ff, D-15ff 
pseudo devices, D-12 3 
SSLC and INP, D-8, D-18 
Configuration file, 1-6, 4-4 
(re)building via NEW command, 4-2, 4-3, 4-19 
DSN/MRJE subsystem, 4-1 
modification via ALTER command, 4-7, 4-9, 4-10 
viewing contents via DISPLAY command, 4-15 
Configuration file entries, Appendix A, 
"Job received" message, A-3, A-8 
active life of jobs, A-5, A-10 
default printer, A-4, A-9 
descriptions of, A-6ff 
host buffer size, A-5, A-10 
host machine ID, A-2 
o host phone number, A-5, A-10 
input device, A-3, A-9 
Job Entry Subsystem, A-2, A-6 
maximum job log entries, A-3, A-9 
print banner, A-2, A-3, A-7 
pseudo console, A-2, A-6 
pseudo line monitor, A-2, A-6 
punch banner, A-2, A-3, A-7 
signon card image, A-2, A-6 
special forms message, A-3, A-8 
translation type, A-5, A-10 
unsolicited print disposition, A-4, A-9 
unsolicited punch disposition, A-4, A-9 
User host console command, A-2, A-6 
Console command mode, definition of, 4-25 
see also Host Console Commands 
Console logging, 
building files for, B-4 
for preserving console output, 4-26 
procedure for initiating, 4-26 
Console Operator command, 
sMRJECONTROL KILL, 5-2, 5-7 
sMRJECONTROL RETRIES, 5-2, 5-8 
s:MRJECONTROL SIGNOFF, 5-2, 5-6 
:MRJECONTROL START, 5-2, 5-3 
s:MRJECONTROL TRACE, 5-2, 5-9 
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:MRJECONTROL CHECK, 5-2, 5-4, 5-11 
Console Operator messages, 6-3, 6-26 
Console Operator, responsibilities, 5-l 
Controller, comunications (see Communications controller) 
Conventions, DSN/MRJE and reference manual, xii 
CS I/O errors, 6-3, 
irrecoverable, 6-3, 6-36 
recoverable, 6-3, 6-44 
CSDUMP.PUB.SYS, program for listing trace file contents, 5-10 
Current host, 
defined, xiv 
destination of job input, 3-11 


D 


Data communications system, elements of, figure, 1-2 
DD card, ‘using with FD files, 2-4 
Default host, 

defined, xiv 

example of jobs submitted to, 3-16 

HOST command, 3-10 
Definitions, DSN/MRJE and reference manual, xiv 
Delimiters, using in commands, xii 
Device class name, 

use in directing job output, 3-13 

use in specifying Infiles, 3-12 

use in specifying pseudo readers, 3-13 
Dial-up lines, 1-1 
Directory file, 1-4, 1-5, 4-4, 

creating via NEW command, 4-2, 4-3, 4-19 
DISPLAY Manager command, 

summary of syntax and function, 4-9 

using the command, 4-16 
DISPLAY User command, 

summary of syntax and function, 3-l 

using the command, 3-6 
DRT number, use in configuring DSN/MRJE into MPE, D-3 
DSN/MRJE Console Operator, defined, v 
DSN/MRJE Manager, defined, v 
DSN/MRJE User, defined, v 


EBCDIC to ASCII, Hollerith character conversions, F-2 
Ellipsis "...", meaning of, xi 
Emergency shutdowns of DSN/MRJE, 5-7 


Entries, configuration file, Appendix A 
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Environment Files for Laser Printer, 2-8, 2-9, 2-10, 3-16 
Error conditions, Section 6, 
CS irrecoverable errors, 6-3, 6-36 
CS recoverable errors, 6-3, 6-44 
syntax errors, 6-1 
transmission errors, 5-9, 5-10 
Executing DSN/MRJE, 1-3 
EXIT User command, 
summary of syntax and function, 3-1 
using the command, 3-8 
Extent allocation for output files, 2-6 


Failures, 


local, 6-1 
remote, 6-2 
FD file, 


definition and use of, 2-1, 2-2 

DSN/MRJE processing of, 3-15 

example of relationship to Infile, 2-5 
##FD card, 

DSN/MRJE reading of, 3-15 

format, 2-4 

Infile reference to, 2-2 

TRANSPARENT parameter, 2-4 
Features of DSN/MRJE, 1-1 
File definition (FD) card images, 2-2 
File designator for job output, 2-11 
File libraries, 2-5 
File names, qualified, use in SUBMIT command, 3-12 
Files, 

configuration, 1-6 

directory, 1-7 

FD, 2-2, 2-3 

Infile, 2-2 

input, 2-2 

job log, 1-7 

LIST formaldesignator, 1-3 

management, 1-6 

message file, 1-8, 4-3, 4-8 

message catalog, 1-7, 4-2, 4-8, 6-45ff, B-1l 

relationships in job stream, figure, 2-3 

stream file, 1-7, 4-8, 5-3ff, B=3 
Fix level, checking, 5-2, 5-5, 5-11, B=-2 
Formal file designator, use in specifying Infiles, 3-12 
Formfile, parameter in SUBMIT command, 3-12ff 
Forms Control statements, 2-8 
Full-duplex transmission mode, C-l 
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Half-duplex transmission mode, C-1l 
Handbook, Communications, for MRJE, Appendix G 
Hardware for DSN/MRJE, 4-1, 
communications controller, 4-1 
communications line, 4-1 
modems, 4-1 
HASP Job Entry System, 2-1 
configuring for DSN/MRJE, E~l 
HELP command, 3-1, 3-9 
Hollerith to EBCDIC to ASCII character conversions, F-2 
Host, defined, xiv 
Host buffer size, 
configuration file entry, A-5, A-10 
limitation on host console messages, 3-19 
Host console commands, l-l, 3-19, 4-26, 
access to, 4-25 
example, 4-25 
format, entered in configuration file, 4-2, 4-9, 4-25 
Host console message logging facility, 4-26 
Host console message logging, building files for, B-=3 
Host ID, 
configuration file entry, A-2, A-6 
defined, xiv 
HOST MACHINE, NEW command prompt, 4-18 
Host number, defined, xiv 
Host system, 
consideration of when preparing jobs, 2-1 
job control on, 2-5 
HOST SYSTEM, NEW command prompt, 4-18 
HOST, parameter in User DISPLAY command, 3-6 
HOST User command, 
summary of syntax and function, 3-1 
using command, 3-8 
using in conjunction with ALTER command, 4-7 
using in conjunction with CANCEL command, 4-9 
using in conjunction with PURGE command, 4-18 
Hostid, defined, xiii 
"Hot" (unspooled) job input, 3-10, 
and communications line, 3-12 
and spooling, 3-12 
HP 2680A Laser Printer, 2-8, 2-9, 2-10, 3-9, 3-12, 4-5 
HP modems, 
37230A modem strappings, Table C-6, C-8 
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Inaccessible file, cause of DSN/MRJE error, 6-1 
Infile, 2-2 
definition and use of, 2-1, 2-2 
example of relationship to FD file, 2-4 
specification in SUBMIT command, 3-12 
INP, 1-1 
DSN/MRJE hardware element, 4-1 
MPE configuration specifications, D-1 
MPE configuration summary, D-18ff 
Input devices, 
available to DSN/MRJE, 1-1 
configuration file entry, A-3, A-4, A-9 
Input files, 1-4, 2-2, 2-6 
Input of jobs, planning for, 1-4 
Installing DSN/MRJE, Appendix B 
Intelligent Network Processor, see INP 
Interactive session, 1-1 
Invalid user ID, cause of DSN/MRJE error, 6-1 
Irrecoverable error codes, 6-4, 6-36 
Itemlist, defined, xiii 


J 


JCL 1-4, 2-1, 2-4, 
card deck, including host console commands in, 3-19, 4-26 
overridden by SUBMIT “FORMS" parameter, 3-14 
JES2 Job Entry Subsystem, 2-1, 
configuring for DSN/MRJE, E-l, E-2 
JES3 Job Entry Subsystem, 2-l, 
configuring for DSN/MRJE, E-2, E-3 
Job control card, relation to job stream, 2-5 (see JCL) 
Job Entry Subsystem, 
configuration file entry, A-2, A-6 
type entered into configuration file, 4-2 
type supported by DSN/MRJE, vi 
Job file libraries, 2-6 
Job input, 2-lff 
Job log file, 1-7, 4-7 
cancellation of entries, 3-1, 3-3 
cannot modify with ALTER command, 4-7 
creating with NEW command, 4-2, 4-14 
errors associated with, 6-1 
initialization via NEW command, 4-3 
maximum entries, configuration of, A-3, A-9 
viewing entries via DISPLAY command, 4-15 
Job name, 
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defined, xiv 


duplicate, cancellation of, 3-3 
Job number, defined, xiv 
Job output, 2-6 





Job received message, configuration file entries, A-3, A-8 


Job stream, 2-1, 2-3, 2-8, 
See also Steam File 


relationship to job control card, 2-5 
relationship to Priority cards, figure, 2-5 
relationships among files in, figure, 2-3 

Joblist, defined, xiii 

JOBLOG ENTRIES, NEW command prompt, 4-15 

JOBLOG, parameter in User DISPLAY command, 3-6 

Jobname, parameter in User CANCEL command, 3-3 

Jobs, 
active life, configuration file entry, A-5, A-10 
cancellation via CANCEL Manager command, 4-9, 4-11 
display of via DISPLAY command, 4-9, 4-14 
planning, 1-4, Section 2 
recovery of after HP 3000 failure, 6-1 
submitting (see SUBMIT User command) 
transmitting and receiving output, 1-4 

JOBS, parameter in User CANCEL command, 3-2 


L 


Laser Printer, HP 2680, 2-8 ff 
Leased communications line, l-l, C-lff 
Libraries of input files, 2-6 
Line continuation character (&), 3-16 
Line errors, (see communications line errors) 
Listing MRJE commands and responses offline, 1-3 
Logging of host console messages, 4-26 
Logical device number, 

use in directing job output, 3-13 

use in specifying Infiles, 3-12 

use in specifying pseudo readers, 3-12 


M 


Management files, 1-6, 
creating via NEW command, 4-18 
maintenance of, 4-6 
Manager commands, 4-9ff 
ALTER, 4-9, 4~-10 
CANCEL, 4-9 a 4-1 2 
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DISPLAY, 4-9, 4-15 
NEW, 4-9, 4-17 
PURGE, 4-9, 4-20 
Manager host console commands, 4-24 
Manager's session, example, 4-23 
‘ianager, DSN/MRJE, 1-1, 
capabilities, 1-3 
MANAGER.SYS, 
logon ID for DSN/MRJE Manager, 4-1, 4-2 
logon ID for starting logging facility, 4-26 
Managing DSN/MRJE, Section 4 
Measurement, Performance, 4-26 
Message catalog file, 1-7, 4-2, 4-8, 6-45ff, B-l 
Message file, 1-8, 4-3, 4-8, B-4 
and Performance Measurement, 4-26 
Messages, 
see also Message Catalog 








associated with :MRJECONTROL command, 6-3, 6-23 
DSN/MRJE, 6-3 
sent to HP system console, 6-26 
User, 6-3, 6-4 
Modem options and strappings, Appendix C 
Bell 201C-L1D, C-2 
Bell 201C, C-4 
Bell 208A, C-5 
Bell 208B, C-6 
Bell 209A, C-7 
HP 37230A, C-8 
Modem speed, maximum, 1-1 
Modems, DSN/MRJE hardware element, 4-1 
Modules, checking version, update and fix levels, 5-2, 5-11,. B-2 
MPE commands 
ALLOW, 5-1 
ALTSEC, 5-8 
MPE configuration, Appendix D 
sMRJE command, for initiating DSN/MRJE operation, 1-3, 3-1, 4-2 
MRJECAT file, 1-7, 4-8, 6-45, B-l 
MRJECON, 1-6 
MRJECONTROL commands, summary of, 5-2 
See also ALLOW, ALTSEC, Stream files 








MRJECONTROL KILL, summary of syntax and function, 5-2 
using the command, 5-6 | 

MRJECONTROL RETRIES, summary of syntax and function, 5-2 
using the command, 5-8 

MRJECONTROL SIGNOFF, summary of syntax and function, 5-2 
using the command, 5-6 

MRJECONTROL START, summary of syntax and function, 5-2 

using the command, 5-3 
MRJECONTROL TRACE, summary of syntax and function, 5-2 
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using the command, 5-9 
MRJECONTROL CHECK, summary of syntax and function, 5-2 
See also Verifying MRJE Installation 





using the command, 5-3, 5-11 


MRJEDIR, 1-6 
MRJEJOB, 1-6 
MRJEMSG, default console logging file, 1-8, 4-3, 4-8, 4-26, B-4 
MRJEOD, 
use with interactive terminal input of data, 2-4, 3-5 
use with SSTDIN(X), 3-15 
MRJESTR, 1-7, 4-8, 5-3, B-3 
Multileaving protocol, 1-1 


N 





Nesting of input files, 2-2 
NEW command, 
summary of syntax and function, 4-6 
using the command, 4-14 
Nesting of input files, 2-2 
NEW command, 
summary of syntax and function, 4-9 
using the command, 4-17 
using to (re)build configuration file, 4-2, 4-3, 4-4 
using to (re)build directory file, 4-2, 4-3, 4-4 
using to (re)build job log file, 4-2, 4-3, 4-4 
using to (re)build management files, 4-2, 4-3, 4-4 
(NCOTRANSLATE]), parameter on ##FD card, 2-4 
(NCOTRANSLATE]), parameter in SUBMIT command, 3-9 








OLDJOBS, defined, 4-15 
SOLDPASS, use in specifying Infiles, 3-12 
ON message (host console), 4-3, 4-24, A-3, A-8 
OP capability, required for Manager, 4-1 
required for Transparent Infiles, 3-12 
Output, 2-6 
Output, unsolicited, 2-6, 3-15, 4-27 
Output, owner of, 2-6, 3-14, 4-27 
Output, destination, 2-6, 4-27 
Output devices, those available to DSN/MRJE, 1-1 
Output files, 
carriage control, 2-7 
disc files, 2-6 
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locating job output, 4-26 

planning, 1-4, 2-6 

record sizes, 2-6 

recovery of after HP 3000 failure, 6-1 

routing, 2-10, 2-11 

specification in SUBMIT command, example, 3-ll, 3-16 
spooled, 2-8 

unspooled, 2-8 


Parameters, use and spelling conventions, xii 
Performance Measurement, 4-26 
Phone number, host, configuration file entry, A-5, A-10 
PHONE NUMBER, NEW command prompt, 4-20 
Planning Job Input and Output, 1-4, Section 2 
Print banner, configuration file entries, A-2, A-3, A-7 
Print files, 

carriage control, 2-7 

default print device, 3-15, A-4, A-9 

record sizes, 2-6 

specification in SUBMIT command, 3-9 
Print streams, 1-1 
Printfile, parameter in SUBMIT command, 3-ll1ff 
/*PRIORITY card, 

DSN/MRJE treatment of, 2-5 

relationship to job stream, 2-5 
Pseudo card punches, MPE configuration specifications, D-2 
Pseudo card readers, 1-4, 

DSN/MRJE software element, 4-2 

mechanism for job input, 3-12 

MPE configuration specifications, D-2 

specification of in "READER" parameter, 3-15 
PSEUDO CONSOLE DEVICE, NEW command prompt, 4-19 
Pseudo console, 

configuration file entry, A-2, A-6 

DSN/MRJE software element, 4-2 

MPE configuration specifications, D-2 
PSEUDO LINE MONITOR DEVICE, NEW command prompt, 4-19 
Pseudo line monitor, 

configuration file entry, A-2, A-6 

DSN/MRJE software element, 4-2 

MPE configuration specifications, D-] 
Pseudo line printers, MPE configuration specifications, D-2 
Punch banner, configuration file entries, A-3, A-7 
Punch files, 

carriage control, 2-7 

record sizes, 2-6 

specification in SUBMIT command, 3-11, 3~-14ff 
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Punch streams, 1-1 

PURGE Manager command, 
summary of syntax and function, 4-9 
use in maintaining job log file, 4-7 
using the command, 4-20 


Q 


Qualified file names, use in SUBMIT command, 3-12 


R 


Reader spool file, deleting input from, 3-2 
Record sizes of output files, 2-6 

Recoverable error codes, 6-3, 6-44 

Retries of transmission after line error, 5-8 
Routing output, 2-10, 2-11 

Running DSN/MRJE, 1-3 


Short-haul modems, C-1, C-8 
/*SIGNOFF card, DSN/MRJE search for, 2-5 
SIGNON card image, 1-5 
SIGNON card image, displayed to MRJE Manager only, 3-6 
format, configuration file entry, A-2, A-6 
SIGNON CARD IMAGE, NEW command prompt, 4-19 
Single-line Synchronous Line Controller, MRJE nekOwanes 
Software elements of DSN/MRJE, 
pseudo card reader, 4-2 
pseudo line monitor, 4-2 
pseudo operator's console, 4-2 
Special forms, 
automatic, 2-8 
default device for, 3-13 
files, carriage control, 2-7 
files, record sizes, 2-6 
message, configuration file entries, A-3, A-8 
processing, 2-8 
specification in SUBMIT command, 3-11 
Spooling, 
bypassing of for "hot" input, 3-12, 3-14 
and communications line, 1-4, 3-14 
SSLC, l-l, 
DSN/MRJE hardware, 4-1 


Index-12 


4-1] 

















MPE configuration specifications, D-1 
MPE configuration summary, D-18ff 
Starting DSN/MRJE session, 1-3 
STATUS, paramter in User DISPLAY command, 3-16 
SSTDIN, 
input file for FD files, 2-4 
inputting jobs through, 3-12, 3-15 
use in specifying Infiles, 3-11 
SSTDINX, 
input file for FD files, 2-4 
inputting jobs through, 3-12, 3-15 
use in specifying Infiles, 3-11 
SSTDLIST, listing device for numbers of submitted jobs, 3-15 
Strapping, modem, Appendix C 
Stream file, 
to initiate communications with the host, 1-7, 4-8, 
5~-3ff, B-3 
Stream jobs, 1l-l 
SUBMIT User command, 2-2 
output file specification in command, 2-6 
special forms output specification, 2-8 
summary of syntax and function, 3-1 
using the command, 3-14 
Submitting jobs, 1-4 
Switched communications line, 1-1, C-lff 
Synchronous Single-line Communications Controller, see SSLC 
Syntax errors, 6-1 
SYSDUMP, D-4, Appendix D 
System failures, 6-1 
System file, defined, xc 
System Supervisor (OP) capability, required for Manager, 4-1 


T 


(T), TRANSPARENT parameter on ##FD card and Infiles, 
2-4, 2-5, 3-12 
TO(OT) files, B-1l 
Trace file, listing contents, 5-10 
Tracing line errors via :MRJECONTROL TRACE, 5-9 
Translation of FD file, 2-4 
Translation type, configuration file entry, A-5, A-10 
Transmission errors, 
retries after, 5-8 
tracing, 5-9, 5-10 
Transmitting jobs and receiving output, 1-4 
Transparent Binary Synchronous Multileaving Communications 
Text Block decribed, Appendix G 
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Unsolicited output, 2-6, 2-11, 2-13, 3-15, 4-27 
Unsolicited print disposition,configuration file entries,A-4, A-9 
Unsolicited punch disposition,configuration file entries,A-4, A-9 
Update level, checking, 5-2, 5-3, 5-11, B-2 
User, DSN/MRJE, 
capabilities, 1-1, 1-2 
defined, v, xv 
User commands, Section 3, 
CANCEL, 3-1, 3=3 
DISPLAY, 3-1, 3-6 
EXIT, 3-1, 3-8 
HELP, 3-l, 3-9 
HOST, 3-1, 3-10, 4-11, 4-13, 4-23 
SUBMIT, 2-2, 2-6, 2-8, 3-l, 3-12 
USER HOST COMMAND, NEW command prompt, 4-19 
User host console commands, 3-19, 
configuration file entry, A-2, A-6 
User messages, (see Messages, User) 


V 


Verification jobs, figure, B-5 
Verification test, DSN/MRJE, Appendix B 
Version level, checking, 5-2, 5-4, 5-11, B-2 
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